A customizable browser extension that gives you total control over YouTube—track playlist runtimes, fine-tune playback speed, auto-scroll Shorts, set custom seek durations, and more. Take control of your YouTube like never before.
- Track Playlist Runtimes: Know exactly how much time you’ll spend binging playlists.
- Custom Playback Controls: Set precise playback speeds and seek durations.
- Auto-Scroll Shorts: Enjoy an uninterrupted flow of Shorts with automatic scrolling.
- Deep Personalization: Tailor every feature to fit your workflow with custom keybindings.
- Privacy-First: No data collection—your browsing remains yours.
Here’s how to set up Toppings for local development:
Ensure the following tools are installed:
- Bun
- Git
- A Google API Key with access to the YouTube API
The repository is organized into three main directories:
- web-ext: Contains the browser extension code.
- backend: Server-side logic built with Cloudflare Workers.
- website: The official homepage of the Toppings extension, built with Next.js.
-
Clone the repository:
git clone https://github.com/enrych/toppings.git cd toppings/web-ext -
Install dependencies:
bun install
-
Start development mode:
For Chrome:
bun run dev
For Firefox:
bun run dev:firefox
Some features require backend functionality. You can run the server locally using Cloudflare Workers.
-
Navigate to the backend directory:
cd ../backend -
Install
wrangler(if not already installed):npm install -g wrangler
-
Add your Google YouTube API secret in
.dev.vars:GOOGLE_SECRET=your-google-youtube-api-key
-
Start the server:
wrangler dev
-
Navigate to the
websitedirectory:cd ../website -
Install dependencies:
bun install
-
Start the development server:
bun run dev
Feedback is always welcome! If you enjoy Toppings, consider:
- Leaving a ⭐ on GitHub
- Reviewing on:
Use these channels to get involved:
- Discussions: For questions or feature ideas, join the GitHub Discussions.
- Issues: Report bugs or request features in the Issues section.
- Wiki: Find detailed documentation in the GitHub wiki.
Toppings is free and open-source. If you find it helpful, consider supporting the development through sponsorships.
Your support helps improve Toppings and keeps it sustainable.
Toppings is licensed under the GPL-3.0 License. You’re free to use, modify, and distribute the extension as long as your work complies with the GPL-3.0 terms.
Happy coding! 😊