Skip to content

An alternative privacy-friendly YouTube frontend which is efficient by design.


Notifications You must be signed in to change notification settings


Repository files navigation


AGPL v3 Matrix Lemmy Registered Users IPFS Build GitHub Repo stars GitHub last commit Translation status

An open-source alternative frontend for YouTube which is efficient by design.

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.


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


Player Trending Channel
Screenshot 1 Screenshot 2 Screenshot 3

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


See for more details.

The source code of the documentation website is available at


The documentation can be found at (accessible via IPNS as well).


To redirect all YouTube links to Piped, you are highly recommended to use either Piped-Redirects, Libredirect or Predirect.



You can help by translating the project to a language you speak at


Forking, and contributing

Development Setup

pnpm install

Compiles and hot-reloads for development

pnpm dev

You can now make changes and view then in realtime!


If you would like to contact me personally, you may do so with the following means:

Please note that isn't meant for support, see Public Chat Rooms/Communities for that.


Donations can be made at:

  • bc1qhq8zjxmu405nvp37njj6zv3s980zg400pu9jfe (BTC)
  • 0x1D77D4cfB1a947514241bcf19B1F04738495e2fD (ETH)
  • 84wyyeGTrg4U1daJufi78bAFrBQgdRhmxJZvgYv8dAFeFVwkJaBEmw5C7fNniUM9n4jfrz3NeG32Agxtp7JNAcCUFPACfwA (XMR, aka Monero)
  • nano_1ngejzydncche4rdua3iebhj7sa95pw5geq4pb8phugtjf3tku933ktjb4pq (Nano)
  • XpzgouDTKCUuE8a92XqjX9b43gKL8oLihw (Dash)

FIAT donations can be made at:

Contributions in any other form are also welcomed.

Made with Piped

Mobile/desktop apps

  • LibreTube - Alternative frontend for YouTube, for Android.
  • YTDLnis - Video and audio downloader for Android that uses Piped to update formats.
  • Yattee - Alternative frontend for YouTube, for MacOS / IOS.
  • PsTube - Watch and download videos without ads on Android, Linux, Windows, iOS, and Mac OSX.
  • Harmony Music - YouTube Music alternative for Android, built with Flutter that supports piped linking for playlists.
  • VibeYou - Privacy focused music player for Android supporting playback via Piped.

Web apps

  • Piped-Material - Fork of Piped, focusing on better performance and a more usable design.
  • Hyperpipe - Alternative privacy respecting front-end for YouTube Music.
  • ytify - Complementary audio streaming frontend for YouTube & YouTube Music.
  • Musicale - Alternative frontend for YouTube Music with style.
  • 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.



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.