ToppingsDocsGitHub

Reference

questions, answered.

If yours isn't here, open an issue.

Does Toppings collect any data?

No. There are no analytics, no telemetry and no accounts. The extension asks for two permissions: youtube.com, so it can add controls to the player, and storage, so your settings survive restarts.

The source is on GitHub under GPL-3.0 if you'd rather check than trust.

Where are my settings stored?

In your browser's extension storage. If browser profile sync is on, they sync through your browser vendor. Toppings runs no sync of its own and never sees your settings.

How does Audio mode work?

It hides the video and keeps the audio. The visible area becomes a black screen, a waveform visualizer, or an image of your choosing. Timeline, chapters, speed and shortcuts keep working.

Can I loop more than one segment?

Yes. Segments let you mark several ranges on a video and play them in order, each with its own loop count and playback rate. Z loads your last-used setup; Shift+Z starts a fresh one.

What is the maximum playback speed?

16× is the ceiling, but audio decoders give up well before that. Under 4× is the practical range. Steps can be as small as 0.0625×.

What are profiles?

Named bundles of YouTube settings: sidebar, comments, end cards, Shorts shelf, feed thumbnails and more. Two presets ship, Audio and Focus. Create your own, then switch from the popup, a shortcut, or the player's gear menu.

Each custom profile can be exported to a JSON file and imported elsewhere. Imports are validated, so a bad file can't corrupt your settings.

Is Toppings available on mobile?

Firefox for Android, yes, from addons.mozilla.org. Chrome for Android doesn't support extensions. Safari isn't planned.

Can I install it without the store?

Yes. Clone the repo, run bun install and bun run build inside web-ext/, then load the dist/ folder from chrome://extensions with Developer mode on, or from about:debugging in Firefox.

A feature says “unavailable on your YouTube”. Why?

YouTube A/B-tests its page structure. When Toppings can't find the element a feature needs, it marks the feature unavailable instead of breaking. Use Report on that row; a fix usually lands in the next patch release.

The buttons don't appear on YouTube.

Check that the extension is enabled, reload the YouTube tab, and make sure you're on a /watch page. If all three are fine, another YouTube extension is probably conflicting; disable them one at a time.

My keybindings stopped working.

Shortcuts pause while you type in a comment or the search box. Click the video to refocus it.