Support

nomus runs as a Chrome extension (Chrome 116 or newer and other Chromium browsers, on Mac, Windows and Linux), as an app for macOS 14.2+ and Linux, and as an Android app (Android 10+). Download page.

Start filtering a Chrome tab

  1. Install nomus from the Chrome Web Store.
  2. Open a tab that plays sound: a video, a podcast, a lecture.
  3. Press ⌘ Shift Y (Ctrl Shift Y on Windows and Linux), or click the nomus icon and choose Filter this tab.
  4. The icon shows ON. Press the shortcut again, or click Stop, to hear the original.

The macOS and Linux apps

To install or upgrade, paste curl -fsSL https://agrohi.com/nomus/install | sh in Terminal. On a Mac it copies nomus into Applications without the "cannot be opened" block; on Debian or Ubuntu it installs the .deb with sudo apt-get install. Read the script first with curl -fsSL https://agrohi.com/nomus/install | less; the download page has the files and checksums if you prefer to install by hand. From 0.11.0 the installer and update files download from dl.agrohi.com, Agrohi's download address on Cloudflare R2; if your network filters downloads, allow that address as well as agrohi.com. To remove nomus, run the same line withsh -s -- uninstall at the end instead of sh.

Open nomus and turn the filter on. It filters everything the computer plays. On macOS the first start asks you to allow system audio recording (Privacy & Security, Screen & System Audio Recording); nomus cannot filter until you allow it. On Linux nomus adds an output device called nomus and makes it the default while the filter is on; it puts your previous output back when you turn it off.

Clean your microphone in calls (beta)

On a Mac or Linux PC, turn on Microphone in the nomus app and choose nomus Microphone in your call app; the Mac needs a small driver, which the app installs with one password prompt. For Mac apps without a microphone menu, such as WhatsApp, nomus 0.10.1 has an experimental switch that makes nomus Microphone the default input while Microphone is on. In Chrome, tick Clean my mic in the extension for Google Meet, the Zoom web client and Discord (extension 0.5.0, not yet in the Chrome Web Store, coming soon; the desktop app covers Zoom, FaceTime, Teams and other apps meanwhile). From 0.11.2 the Mac and Linux apps use Quality, High quality (DeepFilterNet3) by default; Standard (20 ms less delay, lighter on CPU) is one click away on the Microphone card. Steps, delay figures and limits: the microphone page.

The Android app

Start filtering in the app and allow capture when Android asks. For the originals to be muted, you need the one-time setup in the Android setup guide. Without it you hear each app twice.

Common problems

Filter this tab is greyed out
Chrome does not let extensions capture its own pages, such as chrome:// pages, the Chrome Web Store and the new tab page. Open an ordinary website and try again.
The sound plays but nothing changes
Open the nomus popup and check that Mode is nomus-v1, not Bypass, and that Strength is up. If the status line shows an error, click Stop, then Filter this tab again. If that does not help, turn nomus off and on in chrome://extensions.
Some music still comes through
nomus works best when voices lead. When the music is much louder than the speaker, or an instrument sounds very like a voice (a solo violin, a synth lead), part of it passes. Singing is kept on purpose.
The sound is slightly behind the picture
nomus adds 20 milliseconds, too little to see on a speaker's lips. Wireless headphones add their own delay on top. Wired headphones or speakers remove that part.
Only one tab is filtered
nomus filters one tab at a time. Starting it on a second tab moves it there.
Does it work on my phone?
On Android, yes: set it up here. Apps that block audio capture, such as Spotify and Netflix, play unfiltered. There is no iPhone version: iOS does not let an app process other apps' audio.
nomus Microphone is not in my call app's list
Turn the Microphone switch on in nomus first, then reopen the call app's audio settings. On a Mac, check that the driver is installed. More in the microphone limits, including phones and Microsoft Teams in a browser, which are not supported.
The Mac says the driver is installed but not loaded, or that audio did not restart
Press Restart audio on nomus's Microphone card (version 0.10.2 or newer; macOS asks for your password once). If that does not help, run sudo killall coreaudiod in Terminal, or restart your Mac. Versions 0.10.0 and 0.10.1 could also show "Driver not installed" at the same time: macOS 14.4 and newer refuse the way they restarted audio, so the driver stayed unloaded. Update to 0.10.2.
My Mac's input stayed on nomus Microphone
This can happen with the experimental "Use nomus Microphone as my default input while on" switch. If your input ever stays on nomus Microphone, pick your mic in System Settings > Sound > Input. Turning the switch off stops nomus from changing the default input. More.
Is there a Windows app?
No. The Chrome extension works on Windows. Windows lets an app copy what other apps play but not silence the original, so a whole-system filter there would need a signed kernel audio driver.
Linux says it cannot create the nomus device
nomus needs PipeWire 0.3.49 or newer, the default on Ubuntu 24.04, Debian 12, Linux Mint 22 and Pop!_OS 24.04. Ubuntu 22.04 and Linux Mint 21 use PulseAudio by default and are not supported.
My sound output changed after nomus crashed on Linux
Start nomus again. It puts your usual output device back as the default on the next launch.

Report a problem

Email support@agrohi.com with the platform and version (Chrome, macOS, Linux distribution or phone model and Android version), what was playing, and what you heard. nomus collects nothing about you, so a short description is the only way to find the problem.

What nomus does with your data: no audio leaves your device. Read the privacy page.