1
0
mirror of https://github.com/TeamPiped/Piped.git synced 2024-12-13 13:50:27 +05:30
Piped/README.md

160 lines
7.6 KiB
Markdown
Raw Normal View History

2020-12-19 00:25:11 +05:30
# Piped
2020-11-06 09:06:25 +05:30
2021-11-09 23:26:50 +05:30
[![AGPL v3](https://shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0.en.html)
2020-12-01 18:48:24 +05:30
[![Matrix](https://img.shields.io/matrix/piped:matrix.org)](https://matrix.to/#/#piped:matrix.org)
[![Registered Users](https://pipedapi.kavin.rocks/registered/badge)](https://piped.video/register)
2022-01-28 10:02:03 +05:30
[![IPFS Build](https://github.com/TeamPiped/Piped/actions/workflows/ipfs-build.yml/badge.svg)](https://piped-ipfs.kavin.rocks/)
2020-12-01 18:48:24 +05:30
[![GitHub Repo stars](https://img.shields.io/github/stars/TeamPiped/Piped-Frontend?style=social)](https://github.com/TeamPiped/Piped/stargazers)
[![GitHub last commit](https://img.shields.io/github/last-commit/TeamPiped/Piped-Frontend)](https://github.com/TeamPiped/Piped/commits)
2021-08-27 00:24:18 +05:30
[![Translation status](https://hosted.weblate.org/widgets/piped/-/frontend/svg-badge.svg)](https://hosted.weblate.org/projects/piped/frontend/)
2020-12-01 18:04:25 +05:30
2021-11-09 23:26:50 +05:30
An open-source alternative frontend for YouTube which is efficient by design.
2020-11-17 10:45:35 +05:30
# The Problem
YouTube has an extremely invasive privacy policy which relies on using user data in unethical ways. You give them a lot of data - ranging from ideas, music taste, content, political opinions, and much more than you think.
2022-06-13 07:54:06 +05:30
By using Piped, you can freely watch and listen to content without the fear of prying eyes watching everything you are doing.
2020-12-19 00:25:11 +05:30
## Features:
2020-11-06 09:06:25 +05:30
2021-11-09 23:26:50 +05:30
**User Features**
2020-12-19 00:25:11 +05:30
- [x] No Ads
- [x] No Tracking
2021-11-09 23:26:50 +05:30
- [x] Lightweight on server and client
2020-12-19 00:25:11 +05:30
- [x] Infinite Scrolling
2021-11-09 23:26:50 +05:30
- [x] Light/Dark themes
- [x] Login
- [x] Feeds
2022-04-07 10:44:16 +05:30
- [x] Playlists
- [x] Integration with [SponsorBlock](https://github.com/ajayyy/SponsorBlock)
2021-11-09 23:26:50 +05:30
- [x] Integration with [LBRY](https://lbry.com/) for streaming
- [x] Integration with [Return YouTube Dislike](https://returnyoutubedislike.com/) via [RYD-Proxy](https://github.com/TeamPiped/RYD-Proxy)
2020-12-19 00:25:11 +05:30
- [x] 4K support
- [x] No connections to Google's servers
- [x] Playing just audio
- [x] PWA support
2021-11-09 23:26:50 +05:30
- [x] Locally saved Preferences
- [x] [Available in many languages](src/locales), thanks to [our translators](https://hosted.weblate.org/projects/piped/frontend/)
- [x] Embedded video support
2022-09-03 23:12:43 +05:30
- [x] No age restriction
2022-11-27 21:22:34 +05:30
- [x] Bypasses Geo restrictions if possible through a federated network
2021-11-09 23:26:50 +05:30
**Technical Features**
- [x] Multi-region load-balancing
2020-12-19 00:25:11 +05:30
- [x] Performant by design, designed to handle 1000s of users concurrently
2021-11-09 23:26:50 +05:30
- [x] Does not use official YouTube APIs
- [x] Uses [NewPipeExtractor](https://github.com/TeamNewPipe/NewPipeExtractor) to extract information
2022-11-14 07:09:00 +05:30
- [x] Public [JSON API](https://docs.piped.video/docs/api-documentation/)
2022-11-14 08:15:20 +05:30
- [x] Federated protocol on Matrix to let instances collaborate with each other
2021-11-09 23:26:50 +05:30
## Screenshots
2020-11-17 10:45:35 +05:30
2021-11-09 23:26:50 +05:30
| Player | Trending | Channel |
| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| ![Screenshot 1](https://cloudflare-ipfs.com/ipfs/bafybeiaxhsog7jzydr7xb3xhlemxilqksceqg5fraaiuojzclhocsqrcvq) | ![Screenshot 2](https://cloudflare-ipfs.com/ipfs/bafybeigafumvrgbfyufxjptvufobstrywrfv2kteyuuictfko6kvghjszu) | ![Screenshot 3](https://cloudflare-ipfs.com/ipfs/bafybeiehs5xjqmmq34gmewxoqm3j3b2ze3pve4sdmanz7ukrxwgrcmxnry) |
2020-12-19 00:25:11 +05:30
2021-11-09 23:26:50 +05:30
## Public Chat Rooms
- You can join us via Matrix at [#piped](https://matrix.to/#/#piped:matrix.org).
- You can also join us at the libera.chat IRC network which is bridged to the Matrix room at [#piped](https://web.libera.chat/#piped).
2020-11-06 09:06:25 +05:30
## Self-Hosting
2022-11-14 07:09:00 +05:30
See https://docs.piped.video/docs/self-hosting/ for more details.
2021-11-09 23:26:50 +05:30
The source code of the documentation website is available at https://github.com/TeamPiped/Documentation.
## Documentation
2022-11-14 07:09:00 +05:30
The documentation can be found at https://docs.piped.video (accessible via IPNS as well).
2021-11-09 23:26:50 +05:30
## Extensions
To redirect all YouTube links to Piped, you are highly recommended to use either [Piped-Redirects](https://github.com/TeamPiped/Piped-Redirects) or [Libredirect](https://github.com/libredirect/libredirect#readme).
2021-11-09 23:26:50 +05:30
## Contributing
2021-03-29 12:08:29 +05:30
2021-11-09 23:26:50 +05:30
### Translations
2021-11-09 23:26:50 +05:30
You can help by translating the project to a language you speak at https://hosted.weblate.org/projects/piped/frontend/
2021-03-29 12:08:29 +05:30
2022-11-10 02:09:39 +05:30
### Mirrors
- Cloudflare Pages - [cf.piped.video](https://cf.piped.video/)
- Vercel - [vc.piped.video](https://vc.piped.video/)
- Render - [re.piped.video](https://re.piped.video/)
- Fleek - [fl.piped.video](https://fl.piped.video/)
2022-11-10 08:42:07 +05:30
- DigitalOcean - [do.piped.video](https://do.piped.video/)
2022-11-10 02:09:39 +05:30
- Netlify - [nf.piped.video](https://nf.piped.video/)
- Azure - [az.piped.video](https://az.piped.video/)
2021-11-09 23:26:50 +05:30
### Forking, and contributing
2021-03-29 12:08:29 +05:30
2021-11-09 23:26:50 +05:30
- Fork the repository on GitHub: https://github.com/TeamPiped/Piped/fork
- Create your feature branch: `git checkout -b my-awesome-feature`
- Stage your files `git add .`
- Commit your changes `git commit -am 'Add awesome new feature'`
- Push to the branch `git push origin my-awesome-feature`
2022-06-25 11:00:35 +05:30
- Create a new pull request: https://github.com/TeamPiped/Piped/compare
2021-11-09 23:26:50 +05:30
### Development Setup
2020-11-17 10:45:35 +05:30
2020-11-06 09:06:25 +05:30
```
2023-06-17 10:05:30 +05:30
pnpm install
2020-11-06 09:06:25 +05:30
```
2020-12-19 00:25:11 +05:30
### Compiles and hot-reloads for development
2020-11-17 10:45:35 +05:30
2020-11-06 09:06:25 +05:30
```
2023-06-17 10:05:30 +05:30
pnpm serve
2020-11-06 09:06:25 +05:30
```
2021-11-09 23:26:50 +05:30
You can now make changes and view then in realtime!
2021-01-11 20:03:56 +05:30
2021-05-25 17:02:45 +05:30
## Contact
If you would like to contact me personally, you may do so with the following means:
- Matrix: @kavin1337:matrix.org
- Mastodon: https://mastodon.online/@kavin
- Email: kavin@kavin.rocks
2021-11-09 23:26:50 +05:30
## Donations
2021-06-22 01:42:45 +05:30
2021-11-09 23:26:50 +05:30
Donations can be made at:
- bc1qhq8zjxmu405nvp37njj6zv3s980zg400pu9jfe (BTC)
- 0x1D77D4cfB1a947514241bcf19B1F04738495e2fD (ETH)
- 8A5Up8rKgagVAz6TuUduBqHp518H1U6fYc6GqCfWsaEfjGzbSccfYpgMqp5d4oe5Ws5MuFE1iKmhQTadhMhvuk3bHRT5Ebk (XMR, aka Monero)
- nano_1ngejzydncche4rdua3iebhj7sa95pw5geq4pb8phugtjf3tku933ktjb4pq (Nano)
- XpzgouDTKCUuE8a92XqjX9b43gKL8oLihw (Dash)
2021-12-24 16:09:34 +05:30
FIAT donations can be made at: https://liberapay.com/kavin
2021-11-09 23:26:50 +05:30
Contributions in any other form are also welcomed.
2021-06-22 01:42:45 +05:30
2021-12-24 16:09:34 +05:30
# Made with Piped
- [Yattee](https://github.com/yattee/yattee) - an alternative frontend for YouTube, for IOS.
2022-08-30 17:43:56 +05:30
- [LibreTube](https://github.com/Libre-tube/LibreTube) - an alternative frontend for YouTube, for Android.
- [Hyperpipe](https://codeberg.org/Hyperpipe/Hyperpipe) - an alternative privacy respecting frontend for YouTube Music.
2023-01-14 21:32:09 +05:30
- [Musicale](https://github.com/Bellisario/musicale) - an alternative to YouTube Music, with style.
2023-02-18 23:32:37 +05:30
- [ytify](https://github.com/n-ce/ytify) - a complementary minimal audio streaming frontend for YouTube.
- [PsTube](https://github.com/prateekmedia/pstube) - Watch and download videos without ads on Android, Linux, Windows, iOS, and Mac OSX.
- [Piped-Material](https://github.com/mmjee/Piped-Material) - A fork of Piped, focusing on better performance and a more usable design.
2023-03-19 00:59:09 +05:30
- [ReacTube](https://github.com/NeeRaj-2401/ReacTube) - Privacy friendly & distraction free Youtube front-end using Piped API.
2021-12-24 16:09:34 +05:30
2021-01-20 21:23:54 +05:30
## YourKit
2021-01-11 20:03:56 +05:30
2021-11-09 23:26:50 +05:30
![](https://www.yourkit.com/images/yklogo.png)
2021-01-11 20:03:56 +05:30
2021-01-11 20:08:17 +05:30
YourKit has given an open source license for their profiler, greatly simplifying the profiling of Piped's performance.
2021-01-11 20:03:56 +05:30
YourKit supports open source projects with its full-featured Java Profiler.
2021-11-09 23:26:50 +05:30
YourKit, LLC is the creator of [YourKit Java Profiler](https://www.yourkit.com/java/profiler/)
and [YourKit .NET Profiler](https://www.yourkit.com/.net/profiler/),
2021-01-11 20:03:56 +05:30
innovative and intelligent tools for profiling Java and .NET applications.