How it works
No magic, and no server of ours. Here is the whole mechanism, in plain terms.
Audio first, by changing one source
A normal YouTube player can keep downloading video even when the tab is hidden and you only want the sound. YouTube Audio asks YouTube for a direct audio stream, then gives that stream to the page's existing player. The picture goes away, the familiar controls stay, and ongoing video transfer stops. On long listens, that can reduce data use and battery drain.
The three steps
- Ask YouTube for audio. The add-on sends YouTube's InnerTube player service a POST request to /youtubei/v1/player, using the ANDROID_VR client profile. The request contains the video ID and client metadata needed for a player response.
- Check before changing anything. The response must be playable, supported, and include a suitable direct audio format. If it does not pass those checks, the add-on leaves normal YouTube playback alone.
- Make one player swap. One component, called PlayerHandle, is the only part of the extension allowed to write the video element's source. It points that source at the direct audio URL, so the native player keeps its timeline and controls while video bytes stop downloading.
There is no server of ours between your browser and the audio. The lookup goes to YouTube, and the media comes from Google's own media servers.
Credentialless means no YouTube cookies
The audio lookup is made with credentials omitted. In plain terms, the add-on does not attach your YouTube cookies or login to that request. It is built for signed-out use only. YouTube still receives the video ID and client metadata, and can see the request's IP address, just as the Google media host can see the request for the selected stream. The project receives neither request.
Direct media URLs and full player responses stay inside the page-side playback layer. Other parts of the extension receive only limited status information, such as whether audio-only is active or why playback fell back. For the complete network picture, read Privacy.
One owner prevents competing swaps
YouTube is a changing web app, and its mobile player can replace its own media element. Letting several features rewrite the source would invite races, resets, and double playback. PlayerHandle is the sole source writer, while a coordinator watches navigation and settings changes. Stale work is discarded before it can attach to a new video.
When you switch audio-only off, the add-on asks YouTube's own player to resume the same video at the live position and preserves whether it was playing or paused. It does not try to restore an expired captured source. This keeps one player in charge from start to finish.
Fallback is part of the design
Some content cannot be safely replaced with a direct progressive audio source. The add-on deliberately keeps normal YouTube playback for:
- live and DVR streams,
- age-restricted videos,
- members-only uploads,
- content made for kids, and
- any unavailable, failed, or unsupported audio response.
This is called failing open. A feature that is uncertain stops interfering instead of risking a broken player. The popup reports the current video's actual state, so a fallback is visible rather than hidden behind an enabled setting.
Small optional layers, not a rebuilt player
| Layer | What it does | If it cannot help |
|---|---|---|
| Blocking | Blocks selected telemetry requests and removes known ad descriptions from player responses. | The request or original response continues unchanged. |
| Segment skipping | Looks up community timings using only a four-character hash prefix, then matches locally. | No segment is skipped. |
| Loudness and EQ | Uses one local audio graph on YouTube Music to level tracks and apply five EQ bands. | Audio plays without that adjustment. |
| Cleaner controls | Uses bounded page rules and YouTube's own controls to hide clutter, cap quality, or stop autoplay. | The normal page remains. |
These layers do not replace YouTube's player and do not depend on a remote configuration service. They are local, limited, and designed to become no-ops when the page does not match what they expect.
Open to inspection
YouTube Audio is free software under the GPL-3.0 license. You can inspect the source on GitHub, review the privacy details, or start with the audio-only guide. The important boundary is simple: your browser talks directly to the services needed for playback, and no server run by this project sits in the middle.