The complete guide

Everything about CleanShare

How it works, how to install it on every browser, what each setting does, the keyboard, accounts and sharing, and how to fix anything that goes wrong — all in one place.

How it works

One idea, honestly applied.

There is no reliable way for a browser to recognise a spoken word from audio. CleanShare reads the subtitle track instead — the only written record of what is said and when. When a filtered word appears in the subtitles, the audio is muted for that moment. It works on any site with an HTML5 player and subtitles, YouTube included.

That one idea sets the honest boundaries too: no subtitles means no filtering, and the filter can only be as accurate as the subtitle file it reads. Everything else in this guide follows from that.

Two ways of muting — you choose

Just the word (the default): a short mute aimed at the word itself. Subtitle files only record when a whole line starts and ends, so the word’s exact moment inside the line is estimated — usually right, occasionally a beat early or late.

The whole line: the entire subtitle line goes quiet whenever it contains a filtered word. Nothing is estimated, so nothing is ever missed — at the cost of the sentence around the word. Switch between the two any time in the on-video panel (Ctrl Alt S → Silence).

Installing

Unsigned developer builds install by hand rather than from a store. A few minutes, once.

Chrome & Edge

  1. Download the Chrome & Edge build and unzip it.
  2. Open chrome://extensions (or edge://extensions).
  3. Turn on Developer mode — top-right in Chrome, bottom-left in Edge.
  4. Click Load unpacked and choose the unzipped folder.
  5. Pin it: click the puzzle-piece button beside the address bar, find CleanShare, and click the pin (Chrome) or Show in toolbar (Edge). This is what puts the settings button where you can reach it.
  6. Open the site you watch on, click the CleanShare icon, and enable it for that site.

Safari on macOS

  1. Download the Safari build, unzip it, and move CleanShare into your Applications folder.
  2. Right-click it and choose Open, then confirm. The app is not notarised by Apple, so a plain double-click is refused. You only do this once.
  3. In Safari: Settings → Advanced → turn on Show features for web developers.
  4. In the Develop menu, allow unsigned extensions. Where that lives depends on your Safari: on newer versions it is Develop → Developer Settings… → tick Allow unsigned extensions (your Mac password confirms it); on older versions it is a direct Develop → Allow Unsigned Extensions menu line.
  5. Settings → Extensions → tick CleanShare, and allow it on the sites you watch on.
The Safari ritual: the unsigned-extensions switch resets every time Safari fully quits. If CleanShare suddenly does nothing after a restart, re-tick it — that is almost always the whole problem. (An App Store version, which ends this ritual permanently, is in the works.)

First-time setup

  1. Pick a strictness. Click the toolbar icon: Light (only the hard stuff), Family (everything most families mean by “no swearing” — the default), or Strict (adds substitute oaths and insults). Every category can also be toggled individually.
  2. Mute or skip. Choose whether a filtered word is silenced in place or jumped past entirely.
  3. Start a video. The popup shows what the extension sees: how many subtitle lines it has read and how many spots it will filter. If it says “No subtitle file yet”, press Load subtitle track now — players often only fetch subtitles once captions have been switched on once.
YouTube: YouTube does not expose its subtitle file to extensions, so CleanShare reads the captions drawn on screen. That means captions must be on — and if you don’t want to see them, the “Hide subtitles completely” setting keeps them invisible while still filtering. On YouTube the whole caption line is muted rather than the single word.

While you watch

When a filtered word comes up, the audio dips and a small mute label appears in the corner of the video. That label is also a button: if the mute was a mistake — subtitle files sometimes mis-hear a clean word as a bad one — tap it and the sound returns instantly, and that exact spot is remembered as clean for that title, forever.

The popup’s Filtered this session list shows everything acted on, with the word and timestamp, so you can always see exactly what happened and when.

The keyboard

Everything important is reachable without leaving the video.

KeyWhat it does
MMissed word? Mute instantly; press M again when it ends and that range is muted automatically on every future viewing of this title.
UWrong mute? Unmute instantly and remember that spot as clean for this title. (Same as tapping the on-video label.)
\Panic: blur and mute the whole screen now. Press it again when the scene ends — the range is saved and skipped automatically next time.
[  ]Mark a scene’s start and end by hand.
Ctrl Alt SOpen the on-video panel: scene list, word-vs-line switch, timing, shared lists, account.

Every setting, explained

Two places hold the controls, because they do different jobs.

The toolbar popup

SettingWhat it does
Strictness presets & categoriesWhich kinds of language are filtered. Presets are shortcuts; every category can be switched individually underneath.
Mute it / Skip past itSilence the word in place, or jump the player past it.
Start earlyHow far ahead of the word the silence begins. If word-endings are slipping through, raise it; if too much of the sentence dies, lower it.
Hold afterHow long the silence lingers after the word.
Fix timingShifts all muting earlier or later, for titles whose subtitle file runs consistently ahead of or behind the audio. Leave at off unless every single mute is off by the same amount in the same direction.
Mute whenever a filtered word is visibleThe caption-based safety net, used when no subtitle file could be read. Silences the whole visible line.
Blank the word out of subtitlesCensors the word in the on-screen captions.
Hide subtitles completelyKeeps captions invisible while the engine still reads them — essential on YouTube if you don’t want captions showing.
Offer scene lists shared by other viewersLooks up scenes other people published for what you’re watching. Off means no lookups at all.
Skip scenes I have markedMaster switch for your own saved scenes.
Show a small indicatorThe on-video mute label (which is also the tap-to-fix button).
Your own words / Never filter theseAdd words or phrases of your own; exceptions always win over everything else.
Your accountSign in with your email and password right in the popup. Signed in, your scene marks back up to your account automatically (privately) and are restored on any browser you sign into.

The on-video panel (Ctrl Alt S)

ControlWhat it does
Silence: just the word / the whole lineThe precision-versus-certainty choice described above. Takes effect immediately, mid-film.
Scene listEvery saved scene for this title — jump to one, change its action (skip, mute, black out, blur), or delete it.
Typed timestampsEnter a start and end by hand for a scene you know is coming.
Publish my scenesShare this title’s scene list with your groups (needs an account; your first published list is reviewed by hand).
From people you knowLists your groups have published for this title, with names — and anonymous lists from other viewers below.

Accounts & sharing

Filtering never needs an account. Keeping your work safe — and sharing it — does.

Sign in, or your marks are mortal. Scene marks are stored in your browser: reset the browser or remove the extension and they are gone — there is no way back. Signed in, every mark backs up to your account automatically, privately, within seconds — and any browser you sign into restores them. If you mark scenes at all, signing in is the single most important thing on this page.

Why: somebody has to sit through each film and mark its scenes. An account means your family and small group share that work — one person marks a film once, and everyone they know gets the scenes with their name on them: “Dave screened this.”

  1. Create a free account — a display name, an email for verification, a password.
  2. Sign in from the extension popup with your email and password — once per browser. From then on your scene marks back up to your account automatically, privately, and are restored on any browser you sign into.
  3. Create a group, or join one with an invite link. Names are only ever shown inside your groups — strangers see shared lists anonymously.
  4. When you publish a list you choose who sees it: everyone, or my groups only.

Your first published list is read by a human before it appears; after that, yours go live immediately. Accounts can be deleted from the account page, and deleting one removes its lists.

Fixing wrong mutes — and missed words

Subtitle files are transcriptions, and transcriptions make mistakes in both directions. CleanShare gives you a one-keystroke fix for each:

  • It muted a clean word (the transcript mis-heard): press U or tap the mute label. Sound returns instantly and that spot never mutes again on this title.
  • It missed a bad word (the transcript left it out): press M as it starts and M as it ends. That range is muted on every future viewing.
  • A clean word is muted everywhere (you disagree with a list entry): add it to Never filter these in the popup — exceptions always win.
  • A word you want filtered isn’t in our lists: add it to Your own words. Phrases work too.

Corrections are per-title where they should be and global where they should be — and if you publish your scenes, your group inherits your fixes.

Troubleshooting

In rough order of how often each one is the answer.

SymptomFix
“Not running on this site” in the popup The extension isn’t allowed on this website yet. Chrome/Edge: click the icon and enable it for the site. Safari: Settings → Extensions → CleanShare → allow the site — then reload the page. Safari also resets this whenever the app is reinstalled.
Safari: worked yesterday, dead today The unsigned-extensions switch reset when Safari quit. Develop → Developer Settings… → re-tick Allow unsigned extensions, reload the page.
“No subtitle file yet” Press Load subtitle track now in the popup, or switch captions on once in the player. If the title genuinely has no subtitles, CleanShare correctly does nothing — there is nothing to read.
Muting feels early or late on one title If every mute is off by the same amount, that file runs ahead/behind its audio: use Fix timing. If misses vary word to word, that is the word-position estimate — widen Start early/Hold after, or switch Silence to the whole line for certainty.
It muted a clean word U (or tap the label). If the same clean word is muted across many titles, add it to Never filter these.
A bad word got through M … M to fix it forever on that title. Fan-made subtitles miss words; the popup’s session list shows whether the word was even in the file.
Captions on screen don’t match the audio The site attached the wrong subtitle file to that video (it happens on fan-run sites). CleanShare refuses files that name a different video, so it won’t mute from them — but only the site can fix what it displays. Use the site’s Report button.
Whole sentences go quiet You’re in whole-line mode (or on YouTube, where it’s the only mode). Panel → Silence → just the word.
My scene marks disappeared after a browser reset Marks live in browser storage; a reset or reinstall erases them. Marks made while signed in are backed up automatically and restore themselves when you open the title again. Marks made signed out are, sadly, unrecoverable — sign in before you mark.
Not sure what version you’re on The popup footer shows it (e.g. v1.9.33). The latest is always on the download page.

Honest limits

  • No subtitles, no filtering. Nothing to read means nothing to act on.
  • The filter is as good as the transcript. Fan-made subtitles mis-hear, skip, and paraphrase. U and M exist for exactly this.
  • Word-level timing is an estimate. Subtitle files time lines, not words. Perfect word timing exists only where captions carry per-word stamps (YouTube) or where a human marked the scene — which is what scene sharing is for.
  • Words are matched, not meaning. A reverent use and a curse spell the same; both are filtered. Exceptions are one click away.
  • It cannot see the picture. Explicit scenes are only skipped once someone marks them — then never again, for you and your groups.

Privacy

  • Filtering is entirely local. Your wordlists, settings and scene marks live in your browser and are never sent anywhere on their own.
  • Shared-scene lookups send only the video’s address, with no identity attached. Turn Offer scene lists off and nothing is sent at all.
  • Publishing is always a deliberate press, under your display name, shown only to your groups — never to strangers, who see lists anonymously.
  • Accounts hold a display name, an email (verification and password reset only) and your lists. Delete your account any time from your account page.

Get CleanShare

CleanShare is free, shows no ads and collects no data. Built for one family, shared in case it is useful to yours. Found something this guide doesn’t answer? Get in touch.