You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Giorgio Bellisario 14a68e49fe
Add Musicale to
4 months ago
.github Build to dist and rename directory for ci variant. 5 months ago
docker Fix for 404s on frontend. 2 years ago
public Undo changes from efy branch 5 months ago
src Ensure watch history preference actually works. 4 months ago
.dockerignore Include prettier config files. 2 years ago
.gitignore Build application outside of Docker. 9 months ago
.prettierignore Add prettier configuration 2 years ago
.prettierrc.json Change prettier configuration option. 2 years ago
Dockerfile Add curl as dependency before. 5 months ago Build application outside of Docker. 9 months ago
LICENSE Change from CRLF to LF. 3 years ago Add Musicale to 4 months ago
babel.config.js Make eslint work, and fix all warnings. (#511) 2 years ago
index.html Fix regression: flash of white background 7 months ago fixed shebang 5 months ago
package.json Update dependency prettier to v2.8.3 4 months ago
renovate.json Group unocss together and remove dependabot. 7 months ago
uno.config.js Fix auto theme. 9 months ago
vercel.json Add 404 catch-all handler for SPA. 7 months ago
vite.config.js Use stream-browserify instead of stream. 7 months ago
yarn.lock Update dependency prettier to v2.8.3 4 months ago


AGPL v3 Matrix 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

Public Chat Rooms

  • You can join us via Matrix at #piped.
  • You can also join us at the IRC network which is bridged to the Matrix room at #piped.


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 or Libredirect.



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


Forking, and contributing

Development Setup

yarn install

Compiles and hot-reloads for development

yarn serve

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:


Donations can be made at:

  • bc1qhq8zjxmu405nvp37njj6zv3s980zg400pu9jfe (BTC)
  • 0x1D77D4cfB1a947514241bcf19B1F04738495e2fD (ETH)
  • 8A5Up8rKgagVAz6TuUduBqHp518H1U6fYc6GqCfWsaEfjGzbSccfYpgMqp5d4oe5Ws5MuFE1iKmhQTadhMhvuk3bHRT5Ebk (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

  • Yattee - an alternative frontend for YouTube, for IOS.
  • LibreTube - an alternative frontend for YouTube, for Android.
  • Hyperpipe - an alternative privacy respecting frontend for YouTube Music.
  • Musicale - an alternative to YouTube Music, with style.


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.