An excerpt from the repository, fetched Nov 13, 2026.
Read the project’s introduction
Piped
An open-source alternative frontend for YouTube which is efficient by design.
A list of public instances can be found at the documentation here.
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.
By using Piped, you can freely watch and listen to content without the fear of prying eyes watching everything you are doing.
Features:
User Features
No Ads
No Tracking
Lightweight on server and client
Infinite Scrolling
Light/Dark themes
Login
Feeds
Playlists
Integration with SponsorBlock
Integration with LBRY for streaming
Integration with Return YouTube Dislike via RYD-Proxy
4K support
No connections to Google's servers
Playing just audio
PWA support
Locally saved Preferences
Available in many languages, thanks to our translators
Embedded video support
No age restriction
Bypasses Geo restrictions if possible through a federated network
Technical Features
Multi-region load-balancing
Performant by design, designed to handle 1000s of users concurrently
Does not use official YouTube APIs
Uses NewPipeExtractor to extract information
Public JSON API
Federated protocol on Matrix to let instances collaborate with each other
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.
Public Chat Rooms/Communities
You can join us via Matrix at #piped.
You can join us on Lemmy on the !piped@feddit.rocks community.
Self-Hosting
See https://docs.piped.video/docs/self-hosting/ for more details.
The source code of the documentation website is available at https://github.com/TeamPiped/Documentation.
Documentation
The documentation can be found at https://docs.piped.video (accessible via IPNS as well).
The API specification is located at https://github.com/TeamPiped/OpenAPI.
Extensions
To redirect all YouTube links to Piped, you are highly recommended to use either Piped-Redirects, Libredirect or Predirect.
Contributing
Translations
You can help by translating the project to a language you speak at https://hosted.weblate.org/projects/piped/frontend/
Mirrors
Cloudflare Pages - cf.piped.video
Vercel - vc.piped.video
Render - re.piped.video
Fleek - fl.piped.video
DigitalOcean - do.piped.video
Netlify - nf.piped.video
Azure - az.piped.video
Forking, and contributing
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
Create a new pull request: https://github.com/TeamPiped/Piped/compare
Development Setup
pnpm install
Compiles and hot-reloads for development
pnpm dev
You can now make changes and view then in realtime!
Donations
Donations (to Kavin) can be made at:
bc1qhq8zjxmu405nvp37njj6zv3s980zg400pu9jfe (BTC)
0x1D77D4cfB1a947514241bcf19B1F04738495e2fD (ETH)
84wyyeGTrg4U1daJufi78bAFrBQgdRhmxJZvgYv8dAFeFVwkJaBEmw5C7fNniUM9n4jfrz3NeG32Agxtp7JNAcCUFPACfwA (XMR, aka Monero)
nano_1ngejzydncche4rdua3iebhj7sa95pw5geq4pb8phugtjf3tku933ktjb4pq (Nano)
XpzgouDTKCUuE8a92XqjX9b43gKL8oLihw (Dash)
FIAT donations can be made at:
https://liberapay.com/kavin (Initial author)
https://liberapay.com/Bnyro (Project maintainer)
Contributions in any other form are also welcomed.
Made with Piped
Mobile/desktop apps
LibreTube - Alternative frontend for YouTube for Android.
Yattee - Alternative frontend for YouTube for MacOS / iOS.
YTDLnis - Video and audio downloader for Android that uses Piped to update formats.
Pipeline - Alternative frontend for YouTube for Linux.
PlasmaTube - Alternative frontend for YouTube for Linux.
Harmony Music - YouTube Music alternative for Android/Windows/Debian, built with Flutter that supports piped linking for playlists.
Web apps
Hyperpipe - Alternative privacy respecting front-end for YouTube Music.
ytify - Complementary audio streaming frontend for YouTube & YouTube Music.
Piped-Material - Fork of Piped, focusing on better performance and a more usable design.
Musicale - Alternative frontend for YouTube Music with style.
Not Under Active Development
PsTube - Watch and download videos without ads on Android, Linux, Windows, iOS, and Mac OSX.
VibeYou - Privacy focused music player for Android supporting playback via Piped.
conduit - Alternative frontend for YouTube, with a modern player and watch together capabilities.
DeskVideo - Desktop styled, customizable alternative frontend for YouTube.
ReacTube - Privacy friendly & distraction free YouTube frontend.
vidyodl - Simple API to download videos from YouTube, using Piped.
Piped Addon for Kodi - Kodi plugin for Piped.
YourKit
YourKit has given an open source license for their profiler, greatly simplifying the profiling of Piped's performance.
YourKit supports open source projects with its full-featured Java Profiler.
YourKit, LLC is the creator of YourKit Java Profiler
and YourKit .NET Profiler,
innovative and intelligent tools for profiling Java and .NET applications.
Read the full README on GitHub