Notice: Cadmus is deprecated. Please use https://github.com/noisetorch/NoiseTorch.
Cadmus is a graphical application which allows you to remove background noise from audio in real-time in any communication app. Cadmus adds a notification icon to your shell which allows you to easily select a microphone as a source, and subsequently creates a PulseAudio output which removes all recorded background noise (typing, ambient noise, etc). If you find the application useful, leave a ⭐ — it helps!
Whilst software exists on Windows & MacOS (Krisp, RTX Voice, etc) to remove background noise from recorded audio in real-time, no user-friendly solution seemed to exist on Linux. Cadmus was written to address this shortcoming, allowing users to remove background noise from audio in Discord/Zoom/Skype/Slack/etc calls without having to use the commandline. It is primarily a GUI frontend for @werman's PulseAudio Noise Suppression Plugin.
When you run Cadmus, you'll see a new notification icon showing a microphone in your chosen shell. On click, you'll be able to select the microphone whose noise you wish to suppress. Cadmus will then create a new PulseAudio microphone named Cadmus Denoised Output, which will reflect the denoised output of the chosen microphone. You should then be able to select this as an input in any application of your choice. Note that if you're currently recording audio, you'll have to stop recording and start again in order for changes to occur - streams which are currently being recorded will not be hot-swapped to the new input.
- Download the latest
cadmus.debfile on the releases page - Once downloaded, open the file in your chosen file explorer to install it, or run
sudo dpkg -i cadmus.debin a terminal
- Download the latest
cadmus.AppImagefile on the releases page - Once downloaded, open the file in your chosen file explorer to run it (requires AppImage Launcher), or run
chmod +x cadmus.AppImage && ./cadmus.AppImagein a terminal
- Download the latest
cadmus.zipfile on the releases page - Once downloaded, run
unzip cadmus.zip && cd cadmus && ./cadmusin a terminal
If you're using GNOME, you may need to use an extension such as TopIcons Plus Git to view the Tray Icon. See this issue 7.
For now, if you are using the pre-built releases, the plugin is included, so you don't need to install it. See this issue 2.
Ensure that you've selected the output Cadmus Denoised Output in your application of choice. Alternatively, you can set it as the default one in PulseAudio Volume Control (or a similar PulseAudio frontend)
Cadmus has been tested on Arch Linux, Debian 10 and Ubuntu 20.04. It should work with all flavors of Linux with PulseAudio installed - but if you find a bug, please do report it on the GitHub issue tracker. It's still relatively early in development & hasn't been tested extensively.
Cadmus is written in Python 3.6, making use of PyQt5 and the Fman Build System (fbs). To get the project up and running, first clone the repository. Next create a virtualenv using Python 3.6 (fbs doesn't support any higher), and run pip install -r requirements.txt.
Next, clone the noise suppression for voice repository, and build it (see the readme in the repo for more details). Locate the output file librnnoise_ladspa.so and move it to src/main/resources/base. Alternatively you can download the zip archive & locate the relevant file from the resources section of the repository, if you don't want to build from source.
Having done this, you can invoke fbs run in the Cadmus project root directory to run Cadmus from source.
- Add some tests
- Gracefully start up & shut down, removing loaded modules on exit
- Run on startup & use a default microphone?
- Deploy on AUR
Various people have asked me how they can donate to this project. As a consequence, I've created a Patreon