Privacy

Privacy policy.

Updated 14 November 2026

Needle for YouTube (formerly Channel Search+ for YouTube) does not collect, transmit, or sell any data. There is no server, no account, and no analytics. Everything the extension reads stays inside your own browser.

It reads your YouTube account and never changes it, with one exception you have to ask for: tidying your own lists from the panel, meaning removing videos from your Watch Later or your own playlists, and unliking videos. That is off until you turn it on, asks before every change, and can be undone. It has its own section below.

What it reads

When you open the panel on a channel, the extension requests that channel's public video listings from youtube.com, using the same endpoints the site itself uses. Those requests carry your existing YouTube session, exactly as they would if you scrolled the page yourself, which is why your own watch progress appears on the videos. The extension never sees your password, and never asks for it.

On your watch history page it does the same thing with your history, which is your own data on your own account, read the same way the page reads it.

On a search results page, if you open the panel or type a filter into the search bar, it reads the first 200 or so results for that search, the same results the page shows as you scroll.

On a playlist page, yours or anybody's, it reads that playlist's video list. A public playlist is read in full, up to your video limit, the same way the page loads more as you scroll; your own Watch Later and Liked stop at their first 100 unless deep reading is on.

On your subscriptions page it reads the feed's latest page, which is your own data read the way the page reads it. Further pages need deep reading.

If you type in:playlists into the search bar, it reads your Playlists page to find the playlists saved to your library, then the first page of each (every page, with deep reading), at most 25 of them. Only when you ask, and then at most every twelve hours.

It reads nothing outside youtube.com.

When you click into YouTube's search bar, the extension shows matches from your Watch Later, Liked videos and watch history alongside YouTube's own suggestions. To do that without a delay on every keystroke, it keeps a copy of those three lists on your device.

  • It reads the first page of each list, the same page you would see by opening it, with the session your browser already sends. No cookie is read and nothing is signed for this, unless you have also turned on deep reading below.
  • It only reads them when you click into the search bar or open Needle's panel, and at most once every three hours. Nobody who uses neither pays for it.
  • The copy stays in your browser's local storage for youtube.com and is never sent anywhere. Clear copied lists, on the options page under Storage, deletes it.
  • You can turn the whole feature off in the popup ("Your lists in the search bar") or on the options page. YouTube's search bar then behaves exactly as it does without the extension.

Filters you type into the search bar, such as <20m, are removed before YouTube sees your search. YouTube only ever receives the words you were searching for.

The same local copy is what puts "In Watch Later" and "Watched Monday" on YouTube's thumbnails, and Liked and Watched on the panel's cards. Nothing extra is read for that: it compares the video links already on the page against the copy on your device. Watched also comes from YouTube's own red progress bar, which is already in what the page and the panel read.

The one script that runs in YouTube's own page

Everything above runs in the browser's isolated space for extensions, which cannot see or touch YouTube's own JavaScript. One small file, navigate.js, runs inside the page instead, because that is the only way to open a video the way YouTube's own links do, without reloading the whole page, and to open YouTube's own menus.

It does three things.

  • When you click a video in the panel, the search bar or the library row, or press Enter on a search with filters, it asks YouTube to open that address. It accepts only two kinds: a video (/watch?v=) and a search (/results?search_query=, with YouTube's own filter parameter if there is one). If it is missing or YouTube ignores it, the page simply loads normally.
  • It copies YouTube's public API key and client version onto the page, so a followed search can be checked with one small request instead of loading a whole results page first. That key is embedded in every YouTube page for every visitor. It identifies the website, not you. Alongside them it copies which of your signed-in accounts the page is showing: its position (0 for the first account signed in, 1 for the second) and, if you use a brand account, that account's page id. Signed requests (deep reading, and changes to your own lists) send those two numbers so they act for the same account the page shows, the way YouTube's own requests do. They are not credentials.
  • When you press ⋮ on a video in the panel, it opens YouTube's own ⋮ menu for that video: Add to queue, Save to Watch Later, Save to playlist, Download, Share. YouTube only opens that menu from a card it drew itself, so the script borrows one: the data YouTube gave one of its own video cards on the page, with the panel video's id put in place of that card's. It keeps only the menu items that act on a video by its id. Any other, such as "Remove from watch history", names its video in a sealed token and would act on the borrowed card's video, so it is left out. The borrowed card is drawn invisibly with its ⋮ under the one you pressed, and that ⋮ is clicked, so YouTube opens its menu right there. Whatever you pick from it, YouTube does, exactly as from its own cards; the extension sends nothing of its own. The last card borrowed is kept in youtube.com's local storage (ytcs-menu-card, one public video's card as YouTube sent it), for pages whose cards YouTube draws another way, such as Watch Later. Clear copied lists deletes it.

It reads nothing else, and stores nothing else.

What it remembers across searches

YouTube's search forgets you between searches. These features exist because this extension does not, and every one of them is kept on your device.

  • Videos you have been shown. When a search result has actually been on your screen, its video id is noted with a count and a date, up to the most recent 20,000. That is what is:fresh reads to leave out what you have already seen. Only ids are kept, not titles, and only from search results.
  • Searches you follow. Each one is the query as you typed it, filters and all. About every six hours while YouTube is open, the extension asks YouTube for this month's uploads matching it, the same request as searching it yourself, and keeps anything new for the search bar. The query list syncs between your own browsers; what each one has found stays on the device.
  • Channels and words you muted. For a channel, its name, handle and channel id; for a word, the word. Kept on this device only. A muted channel's videos, and videos with a muted word in the title, are hidden from search, Home, Subscriptions and the videos next to the one you're watching. To know whose video a card is, the extension reads YouTube's own data for the page you're on, inside that page, as YouTube sends it: the first page and the results that load as you scroll. It reads a copy and leaves YouTube's untouched, keeps only which channel made which video for as long as the tab is open, and sends none of it anywhere. A Short on Home or in search comes with no channel at all, so for those, and only once you have muted a channel or opened a video's ⋮ menu, the extension asks youtube.com's public oEmbed address (the one any website uses to embed a video) whose video it is: the video's id goes to youtube.com, without your cookies, and the channel's name and handle come back. Export on the options page saves your list as a text file on your computer; Import reads one you choose. Neither goes online.
  • The channels you watch. The channels that appear most in your history have their public video lists read in the background, at most one channel every ten minutes and then once a week each, so in:channels can search them. You can turn this off on the options page ("Index channels you watch").

The follow checks, the channel index and naming Shorts for Mute are the only things the extension does without being clicked. All three only talk to youtube.com, only read public search results, public channel pages and public video details, and stop when YouTube is not open.

Deep reading, and the one thing worth reading carefully

This is the only part of the extension that touches anything resembling a credential, so it is described in full rather than summarised.

It is off by default and does nothing until you turn it on, on the options page, or with the "Search all of it" or "Read all" button the search bar and the panel show when they could only read part of one of your lists. Either way it is the same setting, and the options page switches it off. Left alone, the extension reads roughly the first 180 videos of your history, the first 100 of Watch Later and Liked, and the first page of search results' watch progress, and stops, exactly like every other feature here.

Turned on, it can read further into those lists. Doing that requires signing the request, because YouTube refuses the later pages of your own lists to an unsigned one and answers as though nobody is logged in. The signature is an Authorization: SAPISIDHASH header, which is a SHA-1 of a timestamp, your SAPISID cookie, and https://www.youtube.com. This is precisely what youtube.com's own JavaScript computes for its own requests; the extension does the same calculation for the same server.

To be exact about what that means:

  • The cookie is read from document.cookie on youtube.com, in the page, and is used to compute a hash. The cookie value itself is never stored and never sent anywhere.
  • Only the resulting hash is sent, and only to youtube.com, in a request your browser was already attaching that same cookie to.
  • Nothing about this reaches the author or any third party, because there is still no server to reach.
  • Untick the box and it stops immediately. There is nothing to clean up, since nothing was kept.

It is written this way because the source is public and somebody will eventually read the function that does it. Better that they find it explained here first.

Changing your own lists

The only things the extension can change on your account, and only these: videos in your own Watch Later, in playlists you own, and on your Liked videos, taken out when you pick them and ask, or saved there one at a time when you pick Save in a video's ⋮ menu in the panel.

  • Saving from a video's ⋮ menu. In the panel, each video's ⋮ opens YouTube's own menu (see the script that runs in YouTube's page, above), so a save from it is YouTube's own, made by YouTube. Only where that menu can't be opened (an older Firefox, or before any card of YouTube's has been seen) does the panel show its own: "Save to Watch Later" and "Save to playlist" there add that one video with YouTube's own "Save to playlist" action (ACTION_ADD_VIDEO, at /youtubei/v1/browse/edit_playlist), signed exactly like deep reading below. It needs no switch, since it is one video you picked, the same as YouTube's own Save button; Undo takes it out again straight after. To know where it can go, it first asks what YouTube's own Save dialog asks (/youtubei/v1/playlist/get_add_to_playlist, for that one video): your own playlists, and whether the video is in each already, so nothing is saved twice and Undo never takes out a copy you had before. Nothing from it is kept.
  • Removing is off until you turn it on. The switch is on the options page, under Your lists ("Changing your lists"). The first time you press Remove or Unlike in the panel, it explains what will happen and asks you to allow it there instead.
  • It asks every time. You pick videos in the panel's Select mode, press Remove (or Unlike), and confirm the number. Nothing changes without that confirmation.
  • It is YouTube's own action. In Watch Later the request is the one YouTube's own "Remove from Watch later" menu item sends (ACTION_REMOVE_VIDEO_BY_VIDEO_ID, to playlist WL, at /youtubei/v1/browse/edit_playlist). In your own playlists and on Liked videos, each video arrives from YouTube with its own menu already filled in, and the extension sends exactly the "Remove from" or "Remove from Liked videos" action that menu carries, unchanged. A playlist that is not yours has no such action, so the extension cannot change it and does not offer to. Every change is signed exactly like deep reading above, with the same account numbers the page uses, and touches only the list you are on.
  • Deleted and private videos. YouTube hides them from a list but still counts them. "Find deleted videos" asks YouTube for your list with them shown, the way its own "Show unavailable videos" does (signed, since it is your own list), and offers to remove the ones that are gone. It only reads that list.
  • Undo puts them back, straight after, with YouTube's own "Save to playlist" action (ACTION_ADD_VIDEO), or by liking the video again. YouTube may place them at the end of the list rather than where they were.
  • The removal archive. So that anything can go back later too, not only in the seconds Undo is shown, the extension keeps a short record of what it removed (the video's id, title, channel, length and when it was removed) in your browser, for six months and at most 3,000 videos. "Removed earlier" in the panel shows it and puts videos back. It is never sent anywhere, and Clear cached data deletes it.
  • The local copy of your lists that the search bar uses is updated to match.

Sharing a filter

"Copy a link to this filter" makes a link to a page on the extension's own website. Everything that link carries (which list, and the filters as you typed them) sits after a # in the address, and the part of an address after # is never sent to any server, the website's or YouTube's. The page reads it in your browser only, to show what the filter is.

That page then opens YouTube with the filters after #needle=. A small script, arrive.js, runs as the YouTube page starts loading, copies those filters into the tab's session storage, and the panel applies them once and deletes them. A link made on your Watch Later or history shares only the filters: it opens the other person's own list, never yours.

Play, copy and export

Play opens YouTube's own watch_videos address with the ids of the videos you filtered (up to 50), which YouTube turns into a temporary playlist. Copying writes links or titles to your clipboard only when you press it. CSV and JSON downloads are made in your browser. None of this involves any server but YouTube's.

Watched videos on Home and Subscriptions

If you choose to dim or hide finished videos (off by default, in the popup or on the options page), the extension looks at YouTube's own red progress bar on each thumbnail, and at the copy of your history already on your device. Nothing extra is read and nothing is stored for it. It changes only how those pages look to you.

Pages from the extension's own website

When you first install it, the extension opens one page, https://gottostartsomewhere.github.io/needle/welcome/, which shows where it works. When you remove it, the browser opens https://gottostartsomewhere.github.io/needle/bye/, which asks why. Both are fixed addresses with nothing about you attached: no id, no parameter, nothing to tell one person from another. The site has no analytics.

"Have an issue?" in the popup and at the top of the options page opens a third, https://gottostartsomewhere.github.io/needle/report/, to tell the developer what went wrong. Only what you write there goes, and only when you press Send, to the same Google Form as the goodbye page, marked as a report from somebody who still has Needle.

On the goodbye page, answering is up to you. If you click a reason, that reason, and only that, is sent to a Google Form so the developer can read why people leave. If you then write something in the optional box and press Send, that text is sent too, as a separate answer with the reason in front of it. Nothing else goes with either: no account, no email, nothing from the extension or your browsing. As with any web page, Google's servers see the request itself when it arrives. If you click nothing, nothing is sent.

When a page can't be read

If YouTube changes how it sends a page and Needle can't read it, the panel says so and offers a short report: which kind of page it was, how far the read got, the names and counts of the building blocks YouTube's reply was made of, your Chrome version and language, and Needle's version, video limit and deep reading setting. Never a title, a video, a channel, an address or anything you searched for.

Copy report puts it on your clipboard. Report it opens the report page above in a new tab with that text already written in. It travels in the address's fragment (after #), which a browser never sends to any server, and the page takes it out of the address once it has read it. The extension itself sends nothing: the report only goes if you press Send on that page, where you can read it, or change it, first.

What it stores, and where

All of it is local to your browser. Nothing leaves your machine.

StoredWhereWhy
Video catalogues for channels you openIndexedDBSo reopening a channel is instant
Your watch history, if you open the panel on itIndexedDBSo filtering and sorting it is instant
Your Watch Later, Liked videos and watch history, if the search bar feature is onIndexedDBSo the search bar can match them as you type
Your other playlists' videos, once you have searched them with in:playlistsIndexedDB, with the lists aboveSo that search is instant for the next twelve hours
Whether you prefer the panel as a grid or a list, whether the search bar's intro line has been seen, and whether "What's new" has been readchrome.storage.localSo each one is remembered on this device
Filters you just typed into the search barsessionStorage, for two minutesSo the results page can apply them after YouTube loads it
Filters from a shared link you openedsessionStorage, for one minute, deleted once usedSo the panel can apply them after YouTube loads the page
What the extension removed from your lists: id, title, channel, length, whenIndexedDB, six months, at most 3,000So "Removed earlier" can put them back
How many times, and on how many days, you have found something with it, and how you answered the review promptchrome.storage.localSo the prompt waits until you have come back on another day, and stops for good once you rate or say not to ask again
How far you watched those videosIndexedDB, inside the catalogue aboveSo the watch filters can hide what you have finished
View-count snapshots with timestampsIndexedDBSo growth can be measured between visits
The channels you add to your watchlistIndexedDBSo the list survives a restart
Video ids you have been shown in search results, with counts and datesIndexedDBSo is:fresh can leave them out
What each followed search has foundIndexedDBSo the search bar can show what is new
Public video lists of the channels you watch mostIndexedDB, with the catalogues aboveSo in:channels can search them
Searches you followchrome.storage.syncSo they follow you between your own browsers
Channels and words you mutedchrome.storage.localKept on this device; sync is too small for a long list
Whether the panel has ever been opened, and on how many pages the needle button has said what it doeschrome.storage.localSo the button explains itself to someone new, a few times at most, and never to anyone who has used it
Your settingschrome.storage.syncSo they persist

Watch progress is the most personal of these, so to be exact about it: YouTube already includes it in the listing payload the page itself requests, the extension reads it from there rather than tracking you, and it is written to the same local cache as the rest of the catalogue. It is never transmitted, and unlike your settings it never syncs between devices.

Settings use the browser's own sync storage, so if you have browser sync turned on they travel between your devices through your browser account. That is the browser's mechanism, not ours, and it covers settings and followed searches only. Catalogues, snapshots, watchlists and everything the extension remembers about what you were shown never sync and never leave the device.

What it never does

  • No data is sent to the author or to any third party.
  • Nothing on your YouTube account is changed, except removing videos from your Watch Later or your own playlists, and unliking videos, when you have turned that on and confirmed it.
  • No analytics, telemetry, crash reporting, or advertising.
  • No tracking across sites. The extension only runs on youtube.com.
  • Nothing is sold or shared, because nothing is collected.

Deleting your data

With a YouTube tab open, open the options page (right-click Needle's icon, then Options) and use Clear copied lists, under Storage. That deletes every cached catalogue, every snapshot, your watchlist, your library copy, the record of what you were shown, what followed searches have found, and the removal archive. Followed searches and muted channels are removed one by one in their own lists on the same page. It asks once before doing it, and it cannot be undone. Settings are left alone; Reset settings, next to it, restores those.

Removing the extension deletes its settings and everything in the extension's own storage. The caches above are different: they live in youtube.com's site storage (IndexedDB), because the part of the extension that reads YouTube runs on youtube.com, and the browser does not clear a website's storage when an extension is removed. They are never sent anywhere either way. To remove them too, use Clear cached data before removing the extension, or afterwards clear site data for youtube.com in your browser's settings. (Earlier versions of this policy said removal deleted everything; that was wrong about these caches.)

Cached catalogues are capped at the 40 most recently read channels, so the cache does not grow without limit as you browse. Your watchlist is exempt from that, since it is a choice you made rather than a cache.

Permissions, and why each is needed

  • storage keeps your settings between sessions.
  • Access to youtube.com is what lets the panel read a channel's listings and draw itself on the page. It is limited to www.youtube.com and no other site.

No additional permission is requested for deep watch history or for changing your own lists. Both use the youtube.com access the extension already has, which is why their switches exist at all: the capability could not be gated by the browser, so it is gated by you.

Source

The extension is free, with no paid tier, and licensed under the PolyForm Noncommercial licence. Its code ships as plain, readable JavaScript inside the extension itself, nothing compiled or hidden, so every claim above can be checked against what your browser actually runs.

Contact

Use the developer contact on Needle's Chrome Web Store listing: https://chromewebstore.google.com/detail/needle-for-youtube-channe/magofcbhfhpfabphcldhodhgehhclokc.