How it works

How Unshorted leaves out Shorts and ads

Unshorted is free software, and how it works is no secret. This page says how the app gets YouTube's lists without their Shorts and ads, how videos play in YouTube's own player without its ads, and what happens when YouTube answers back. The video says the same in under two minutes.

1:40, with captions. Everything it says is written out below, with more detail.

The short version

  • Your phone asks YouTube itself, the way youtube.com does, from a hidden page inside the app. Nothing passes through a server of ours.
  • Only videos, channels and playlists are read from YouTube's answers. What's inside an ad or a Short is never looked at, wherever YouTube puts it.
  • The player never schedules an ad: the ads are taken out of a video's data before YouTube's player reads it, and WebKit refuses requests to Google's ad servers.
  • If YouTube answers back by holding a video, the player says so and loads the video another way.
  • Nothing plays by itself. When a video ends, what's next is your choice.

The lists

Your phone asks YouTube itself

YouTube's website loads nearly everything from its own API, called InnerTube: a JSON request for each screen (browse for Home, Subscriptions, channels, playlists and your library, search, and next for a video's page), and JSON back. Unshorted sends the same requests, with the same details the website sends, from a web page on www.youtube.com that the app keeps loaded, out of sight. So each request carries the website's cookies and the browser's own headers, and your session never leaves your phone.

The answers come straight from YouTube to your phone. No server of ours is in between, and none exists.

Only videos, channels and playlists are read

YouTube's answers nest a few kinds of items (videos, channels, playlists) in grids, shelves, sections and tabs that change from one experiment to the next. Unshorted's parser doesn't try to follow that layout. It walks the whole answer and keeps, in order, the items it recognises. It skips anything inside an ad (promoted videos, banners, the masthead, sponsored search results, companion ads) and anything inside a Shorts shelf or a Short, so nothing in them is ever read. It also drops any video whose link would open the Shorts player, mixes (endless autoplay lists) and community posts.

On the left, YouTube's answer as a list: Video, Shorts shelf, Ad, Channel, Short, Video, Promoted video, Playlist. The videos, the channel and the playlist have a check; the Shorts and the ads are struck through. An arrow labelled Unshorted leads to a phone whose list holds only the two videos, the channel and the playlist.

What one search looked like

In one search for "funny cats" in November 2026, YouTube's answer held 40 Shorts and 5 promoted results. None of them showed. Home, in another check that month, held 18 Shorts and 4 ad slots; none of those showed either.

Short clips listed as ordinary videos

YouTube also lists some short clips as ordinary videos, outside its Shorts shelves; recent vertical ones are Shorts in all but name. You › Hide Videos Under a Minute, on at first, leaves videos shorter than a minute out of the lists YouTube fills: Home, Subscriptions, search and Up Next. A channel's own videos, playlists and your own lists still show them. Switch it off to see them everywhere.

On YouTube's own pages too

A few things open YouTube's mobile website inside the app: "Website" under a video, and "Open on YouTube" when the player can't play something. There, Shorts shelves, tabs and links are hidden, a Shorts address opens as an ordinary video, and ad slots are hidden.

The player

YouTube's own player, without its ads

Videos play in YouTube's own player, from its mobile website, in a web view under the native screen. Before any of YouTube's scripts run, the app adds one of its own that takes the ads out of a video's data (its ad placements, ad slots and player ads) wherever that data arrives: written into a page, fetched from the API, or brought by the site's own navigation. The player then never schedules an ad. YouTube's "ad blockers aren't allowed" message arrives the same way, and goes too.

Requests to ad servers are refused

The app also gives WebKit, Apple's web engine, a list of addresses to refuse: Google's ad servers (doubleclick.net, googlesyndication.com) and YouTube's own ad requests (/pagead/, /api/stats/ads, the player's ad_break…). Whatever asks for them, nothing comes back.

If an ad slips through

If an ad plays anyway, it's muted, skipped when it can be and sped through when it can't, and the player shows "Skipping an ad…" while it happens.

When YouTube answers back

YouTube can hold a video back for as long as the ad it expected to show would have lasted: 10 to 30 seconds of nothing. In November 2026 it did this when the player fetched a video itself, but not when the site's own navigation did, so that's how the app puts each video on the player (how, and why it's faster). When a video is held anyway, the player says what's going on, in plain words:

  • "YouTube is holding this video back for the length of the ad it didn't get to show."
  • After five seconds without a picture: "This is taking longer than usual. Loading the video another way…", and the app loads the video's page from scratch, which isn't held.
  • If that is held too, it says the video starts by itself when that time is up. There's only the wait left, and the video does start.

Nothing plays next by itself

YouTube's autoplay, its switch and its next-video button are gone, and a video the app didn't ask for is stopped. When a video ends, "Watch Again" shows; what's next is your choice, in Up Next, where there are no Shorts and no ads either.

What it doesn't cover

  • Sponsorships creators read out in their own videos. They're part of the video.
  • Ads YouTube stitches into a video's stream itself. Nothing can take those out of the data, so they can only be waited out.
  • What YouTube changes next. It changes its website constantly, mostly through experiments; the parser and the scripts are built to bend rather than break, and MAINTAINING.md says what to do when something gets through.

Check it yourself

Unshorted is free software under the GNU General Public License, version 3. Everything described here is in its repository, which is private for now (ask for access):

One caution

Unshorted isn't made or endorsed by YouTube or Google. YouTube's terms don't allow blocking its ads, and it could limit playback or an account that does. Use it at your own risk.

Questions

Does Unshorted block every ad on YouTube?

The ads in YouTube's lists and in its player, yes. Not sponsorships creators read out in their videos, and not ads YouTube stitches into a video's stream itself.

Can I still see Shorts?

No. Shorts don't appear anywhere in Unshorted, and there's no Shorts tab in the app or on channels. Short clips that YouTube lists as ordinary videos show again if you switch off You › Hide Videos Under a Minute.

Why does a video sometimes wait before it starts?

YouTube can hold a video back for as long as the ad it expected to show would have lasted. The player says so when it happens, loads the video another way after five seconds, and otherwise the video starts by itself when that time is up.

Does a server of Unshorted's see what I watch?

No. There's no such server: your phone talks straight to YouTube, and Shorts and ads are left out on the phone. How Unshorted keeps your account private.

The video was made with free software, from files in the repository: its voice is Kokoro, an open text-to-speech model, and its pictures and sounds are drawn by a script. Next: how videos start in under a second, and keep playing.