Superpowers
OmniTube
OmniTube plays YouTube and YouTube Music inside OmniGet, with your account or without one. It adds SponsorBlock, DeArrow, filters for what you do not want to see, and a download button that uses the same quality menu as the rest of the app.
OmniTube is not affiliated with YouTube or Google.
Where it is
Superpowers › OmniTube. To turn it off or on: Settings › Integrations › OmniTube, switch Enable OmniTube. Its own settings are under Settings at the bottom of OmniTube’s guide.
How to use it
- Open OmniTube. Use the switch at the top to pick Videos or Music.
- Search with the box at the top, or browse Home.
- Click a video to open it. Below the player you find the description, chapters, comments and Up next.
- To save a video, open Download under the player and pick Video or Audio only, a quality and what to do with sponsor segments (Keep all, Mark chapters or Cut out). It goes to the normal queue.
Videos
| Guide entry | What it shows |
|---|---|
| Home | Recommendations. |
| Shorts | Short videos. |
| Subscriptions | New videos from the channels you follow, by day. |
| You | Your account, history, playlists and Watch later. |
| History | Your watch history, with search and Clear all watch history. |
| Playlists, Watch later, Liked videos | Your lists. |
| Downloads | Opens OmniGet’s download queue. |
Music
| Guide entry | What it shows |
|---|---|
| Home | Quick picks, moods and shelves. |
| Explore | New releases, Charts and Moods & genres. |
| Library | Your playlists, albums and Liked music. |
Music keeps playing while you move around the rest of OmniGet. Endless radio adds similar songs when the queue runs out.
With or without an account
- Without an account, everything works: subscriptions, history and Watch later stay on this computer (Subscriptions on this device).
- To sign in, open Settings › Account in OmniTube and click Sign in. A sign-in window opens; when it finishes, the account is saved in OmniGet’s cookie vault, like any other account.
- If you already imported YouTube cookies into OmniGet, Use the account from the cookie vault signs in with them.
Use only your own account.
Import and export
Import and export (at the bottom of the guide) brings in subscriptions and history from other apps. Drop a file or choose one; the format is detected for you. Nothing leaves your computer.
| Source | What it reads |
|---|---|
| NewPipe | Subscriptions export (.json) or the full backup (.zip) with history and playlists. |
| FreeTube | Profiles, subscriptions and history from FreeTube’s data folder. |
| Google Takeout | The YouTube export zip, subscriptions.csv or watch-history.json. |
| OPML | Subscription feeds from RSS readers and other apps. |
| Links | A text file with one channel link or ID per line. |
Export saves your local subscriptions for another app.
Options
OmniTube’s Settings has these sections: Account, Playback, SponsorBlock, DeArrow and dislikes, Distractions, Filters, Appearance, Downloads and automation and Import and export.
Playback
| Option | What it does | Default |
|---|---|---|
| Default quality | Auto picks the best that fits the player size. | Auto |
| Preferred video codec | H.264 is the lightest to decode; AV1 looks best at the same size. | Auto |
| Music audio quality | Premium uses your subscription’s audio; High uses more data; Low saves bandwidth. | High |
| Autoplay next video | Plays the next one from the playlist or Up next. | On |
| Start playing when a video opens | Turn off to open videos paused. | On |
| Preview on hover | Plays a muted preview when the pointer rests on a thumbnail. | On |
| Normalize volume | Keeps loud songs and videos at a similar level. | On |
| Endless radio | Keeps adding similar songs when the music queue runs out. | On |
| Lyrics | Auto tries OmniTube Music first, then LRCLIB for synced lyrics. | Auto |
| Send watch history to the account | What you watch here also shows up in your YouTube history. Only when signed in. | On |
SponsorBlock
Use SponsorBlock (on by default) shows crowd-sourced segments on the progress bar in their category color. For each category you choose Skip, Ask, Only show or Off.
| Category | Default |
|---|---|
| Sponsor | Skip |
| Non-music section | Skip |
| Self-promotion | Ask |
| Interaction reminder | Ask |
| Intro, Endcards and credits, Preview or recap, Hook, Highlight, Exclusive access | Only show |
| Filler tangent | Off |
SponsorBlock in downloads marks segments as chapters or cuts them out of downloaded files (off by default). Channels without SponsorBlock lists channels where nothing is skipped. Server changes only if you run your own SponsorBlock mirror.
DeArrow and dislikes
| Option | What it does | Default |
|---|---|---|
| DeArrow titles | Replaces clickbait titles with ones written by the community. | Off |
| DeArrow thumbnails | Uses a frame from the video instead of the custom thumbnail. | Off |
| Show dislikes | Estimated dislike count from Return YouTube Dislike. | On |
Distractions and filters
Presets set many switches at once: Clean (no members-only videos, mixes, games or end screens), Focus (Clean, plus an empty home, no related videos, no Shorts and no videos you already watched) and Seeker (Focus, plus no comments, opening on Subscriptions).
| Option | Default |
|---|---|
| Hide members-only, Hide mixes, Hide games, Hide end screens | On |
| Hide Shorts, Hide live streams, Hide upcoming, Hide posts, Empty home, Hide related videos, Hide comments, Hide topic chips, Hide counts | Off |
| Hide videos you watched | Off. When on, a video counts as watched at 85%. |
| Infinite scroll | On |
Filters hides videos everywhere except Subscriptions: Blocked channels (block one from any video’s ⋮ menu), Blocked words (with Match whole words only, on by default), and Minimum length / Maximum length.
Appearance
Look is Classic (YouTube’s own colors, the default) or OmniGet theme. Open in picks Videos or Music first, Start page the first screen of the Videos side, and Grid columns the videos per row.
Downloads and automation
- Download folder: by default the same as OmniGet’s download folder.
- Auto-download rules: new videos from your local subscriptions that match a rule are downloaded on their own. A rule has channels, words the title must or must not contain, length limits, quality, SponsorBlock handling, a folder, and how many files to keep. See what it would download previews the rule before you save it. Check now runs the rules right away.
- Disk limit for automatic downloads: when it is full, the oldest automatic downloads go to the trash. Pinned ones stay.
Shortcuts
Press ? inside OmniTube to see this list.
| Key | Action |
|---|---|
| K or Space | Play or pause |
| J / L | Back or forward 10 seconds |
| ← / → | Back or forward 5 seconds |
| ↑ / ↓ | Volume up or down |
| M | Mute |
| F | Full screen |
| T | Theater mode |
| I | Mini player |
| C | Captions on or off |
< / > |
Slower or faster |
| 0 to 9 | Jump through the video in tenths |
| ⇧NShift+N / ⇧PShift+P | Next or previous |
| ↩Enter | Skip or undo a SponsorBlock segment |
| / | Search |
| ⌥←Alt+← | Go back |
Common problems
A video does not play or download
OmniTube uses yt-dlp and FFmpeg as helpers for playback and downloads. Settings › Account shows whether both are found. If one is missing, install it in Settings › Dependencies of the app (see Dependencies).
Sign-in did not finish
The sign-in window closes only after YouTube confirms the login. If you closed it early, click Sign in again.
Some videos never show up
Check Distractions and Filters: a preset, a blocked word or a length limit may hide them. Subscriptions is not filtered by blocked channels.