Piped/README.md

182 lines
9.2 KiB
Markdown
Raw Permalink Normal View History

2020-12-18 18:55:11 +00:00
# Piped
2020-11-06 03:36:25 +00:00
2021-11-09 17:56:50 +00:00
[![AGPL v3](https://shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0.en.html)
2020-12-01 13:18:24 +00:00
[![Matrix](https://img.shields.io/matrix/piped:matrix.org)](https://matrix.to/#/#piped:matrix.org)
2023-07-23 09:10:35 +00:00
[![Lemmy](https://img.shields.io/lemmy/piped%40feddit.rocks)](https://feddit.rocks/c/piped)
[![Registered Users](https://pipedapi.kavin.rocks/registered/badge)](https://piped.video/register)
2022-01-28 04:32:03 +00:00
[![IPFS Build](https://github.com/TeamPiped/Piped/actions/workflows/ipfs-build.yml/badge.svg)](https://piped-ipfs.kavin.rocks/)
2020-12-01 13:18:24 +00:00
[![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-26 18:54:18 +00:00
[![Translation status](https://hosted.weblate.org/widgets/piped/-/frontend/svg-badge.svg)](https://hosted.weblate.org/projects/piped/frontend/)
2020-12-01 12:34:25 +00:00
2021-11-09 17:56:50 +00:00
An open-source alternative frontend for YouTube which is efficient by design.
2020-11-17 05:15:35 +00:00
# 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 02:24:06 +00:00
By using Piped, you can freely watch and listen to content without the fear of prying eyes watching everything you are doing.
2020-12-18 18:55:11 +00:00
## Features:
2020-11-06 03:36:25 +00:00
2021-11-09 17:56:50 +00:00
**User Features**
2020-12-18 18:55:11 +00:00
- [x] No Ads
- [x] No Tracking
2021-11-09 17:56:50 +00:00
- [x] Lightweight on server and client
2020-12-18 18:55:11 +00:00
- [x] Infinite Scrolling
2021-11-09 17:56:50 +00:00
- [x] Light/Dark themes
- [x] Login
- [x] Feeds
2022-04-07 05:14:16 +00:00
- [x] Playlists
- [x] Integration with [SponsorBlock](https://github.com/ajayyy/SponsorBlock)
2021-11-09 17:56:50 +00:00
- [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-18 18:55:11 +00:00
- [x] 4K support
- [x] No connections to Google's servers
- [x] Playing just audio
- [x] PWA support
2021-11-09 17:56:50 +00:00
- [x] Locally saved Preferences
- [x] [Available in many languages](src/locales), thanks to [our translators](https://hosted.weblate.org/projects/piped/frontend/)
2021-11-09 17:56:50 +00:00
- [x] Embedded video support
2022-09-03 17:42:43 +00:00
- [x] No age restriction
2022-11-27 15:52:34 +00:00
- [x] Bypasses Geo restrictions if possible through a federated network
2021-11-09 17:56:50 +00:00
**Technical Features**
- [x] Multi-region load-balancing
2020-12-18 18:55:11 +00:00
- [x] Performant by design, designed to handle 1000s of users concurrently
2021-11-09 17:56:50 +00:00
- [x] Does not use official YouTube APIs
- [x] Uses [NewPipeExtractor](https://github.com/TeamNewPipe/NewPipeExtractor) to extract information
2022-11-14 01:39:00 +00:00
- [x] Public [JSON API](https://docs.piped.video/docs/api-documentation/)
2022-11-14 02:45:20 +00:00
- [x] Federated protocol on Matrix to let instances collaborate with each other
2021-11-09 17:56:50 +00:00
## Screenshots
2020-11-17 05:15:35 +00:00
2021-11-09 17:56:50 +00:00
| 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-18 18:55:11 +00:00
## Having trouble?
If you have any general questions regarding how Piped works or trouble setting up your own instance, please consult the following public chat rooms and documentation for help. Please use these platforms exclusively for such cases and do NOT open an issue.
2021-11-09 17:56:50 +00:00
### Public Chat Rooms/Communities
2023-07-11 03:24:35 +00:00
- You can join us via Matrix at [#piped](https://matrix.to/#/#piped:matrix.org).
2023-07-11 03:24:35 +00:00
- You can join us on Lemmy on the [!piped@feddit.rocks](https://feddit.rocks/c/piped) community.
### Self-Hosting
2022-11-14 01:39:00 +00:00
See https://docs.piped.video/docs/self-hosting/ for more details.
2021-11-09 17:56:50 +00:00
The source code of the documentation website is available at https://github.com/TeamPiped/Documentation.
### Documentation
2022-11-14 01:39:00 +00:00
The documentation can be found at https://docs.piped.video (accessible via IPNS as well).
2021-11-09 17:56:50 +00:00
## Extensions
To redirect all YouTube links to Piped, you are highly recommended to use either [Piped-Redirects](https://github.com/TeamPiped/Piped-Redirects), [Libredirect](https://github.com/libredirect/libredirect) or [Predirect](https://github.com/libreom/predirect).
2021-11-09 17:56:50 +00:00
## Contributing
2021-03-29 06:38:29 +00:00
2021-11-09 17:56:50 +00:00
### Translations
2021-11-09 17:56:50 +00:00
You can help by translating the project to a language you speak at https://hosted.weblate.org/projects/piped/frontend/
2021-03-29 06:38:29 +00:00
2022-11-09 20:39:39 +00:00
### 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 03:12:07 +00:00
- DigitalOcean - [do.piped.video](https://do.piped.video/)
2022-11-09 20:39:39 +00:00
- Netlify - [nf.piped.video](https://nf.piped.video/)
- Azure - [az.piped.video](https://az.piped.video/)
2021-11-09 17:56:50 +00:00
### Forking, and contributing
2021-03-29 06:38:29 +00:00
2021-11-09 17:56:50 +00:00
- 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 05:30:35 +00:00
- Create a new pull request: https://github.com/TeamPiped/Piped/compare
2021-11-09 17:56:50 +00:00
### Development Setup
2020-11-17 05:15:35 +00:00
2020-11-06 03:36:25 +00:00
```
2023-06-17 04:35:30 +00:00
pnpm install
2020-11-06 03:36:25 +00:00
```
2020-12-18 18:55:11 +00:00
### Compiles and hot-reloads for development
2020-11-17 05:15:35 +00:00
2020-11-06 03:36:25 +00:00
```
2024-02-23 07:10:08 +00:00
pnpm dev
2020-11-06 03:36:25 +00:00
```
2021-11-09 17:56:50 +00:00
You can now make changes and view then in realtime!
2021-01-11 14:33:56 +00:00
2021-05-25 11:32:45 +00:00
## 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
2024-01-20 01:02:36 +00:00
Please note that isn't meant for support, see [Public Chat Rooms/Communities](#public-chat-roomscommunities) for that.
2021-11-09 17:56:50 +00:00
## Donations
2021-06-21 20:12:45 +00:00
2021-11-09 17:56:50 +00:00
Donations can be made at:
- bc1qhq8zjxmu405nvp37njj6zv3s980zg400pu9jfe (BTC)
- 0x1D77D4cfB1a947514241bcf19B1F04738495e2fD (ETH)
2024-03-14 02:38:42 +00:00
- 84wyyeGTrg4U1daJufi78bAFrBQgdRhmxJZvgYv8dAFeFVwkJaBEmw5C7fNniUM9n4jfrz3NeG32Agxtp7JNAcCUFPACfwA (XMR, aka Monero)
2021-11-09 17:56:50 +00:00
- nano_1ngejzydncche4rdua3iebhj7sa95pw5geq4pb8phugtjf3tku933ktjb4pq (Nano)
- XpzgouDTKCUuE8a92XqjX9b43gKL8oLihw (Dash)
2024-03-07 22:44:24 +00:00
FIAT donations can be made at:
- https://liberapay.com/kavin (Author of project, used for Project infrastructure maintenance, and official instance)
2024-03-07 22:44:24 +00:00
- https://liberapay.com/Bnyro (Maintainer of repo)
2021-12-24 10:39:34 +00:00
2021-11-09 17:56:50 +00:00
Contributions in any other form are also welcomed.
2021-06-21 20:12:45 +00:00
2021-12-24 10:39:34 +00:00
# Made with Piped
**Mobile/desktop apps**
- [LibreTube](https://github.com/Libre-tube/LibreTube) - Alternative frontend for YouTube for Android.
2023-07-13 18:03:14 +00:00
- [YTDLnis](https://github.com/deniscerri/ytdlnis) - Video and audio downloader for Android that uses Piped to update formats.
- [Yattee](https://github.com/yattee/yattee) - Alternative frontend for YouTube for MacOS / iOS.
- [PlasmaTube](https://apps.kde.org/plasmatube/) - Alternative frontend for YouTube for Linux.
- [PsTube](https://github.com/prateekmedia/pstube) - Watch and download videos without ads on Android, Linux, Windows, iOS, and Mac OSX.
- [Harmony Music](https://github.com/anandnet/Harmony-Music) - YouTube Music alternative for Android, built with Flutter that supports piped linking for playlists.
- [VibeYou](https://github.com/you-apps/VibeYou) - Privacy focused music player for Android supporting playback via Piped.
2021-12-24 10:39:34 +00:00
**Web apps**
- [Piped-Material](https://github.com/mmjee/Piped-Material) - Fork of Piped, focusing on better performance and a more usable design.
- [Hyperpipe](https://codeberg.org/Hyperpipe/Hyperpipe) - Alternative privacy respecting front-end for YouTube Music.
- [ytify](https://github.com/n-ce/ytify) - Complementary audio streaming frontend for YouTube & YouTube Music.
- [Musicale](https://github.com/Bellisario/musicale) - Alternative frontend for YouTube Music with style.
- [conduit](https://github.com/ai25/conduit) - Alternative frontend for YouTube, with a modern player and watch together capabilities.
- [DeskVideo](https://github.com/malisipi/DeskVideo) - Desktop styled, customizable alternative frontend for YouTube.
- [ReacTube](https://github.com/NeeRaj-2401/ReacTube) - Privacy friendly & distraction free YouTube frontend.
**Other**
- [vidyodl](https://github.com/MrKovar/vidyodl) - Simple API to download videos from YouTube, using Piped.
- [Piped Addon for Kodi](https://github.com/syhlx/plugin.video.piped) - Kodi plugin for Piped.
2021-01-20 15:53:54 +00:00
## YourKit
2021-01-11 14:33:56 +00:00
2021-11-09 17:56:50 +00:00
![](https://www.yourkit.com/images/yklogo.png)
2021-01-11 14:33:56 +00:00
2021-01-11 14:38:17 +00:00
YourKit has given an open source license for their profiler, greatly simplifying the profiling of Piped's performance.
2021-01-11 14:33:56 +00:00
YourKit supports open source projects with its full-featured Java Profiler.
2021-11-09 17:56:50 +00:00
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 14:33:56 +00:00
innovative and intelligent tools for profiling Java and .NET applications.