-
Notifications
You must be signed in to change notification settings - Fork 234
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #304 from RiemaruKarurosu/master
Readme Restore
- Loading branch information
Showing
1 changed file
with
98 additions
and
16 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,24 +1,106 @@ | ||
| <img src="https://raw.githubusercontent.com/noisetorch/NoiseTorch/master/assets/icon/noisetorch.png" width="100" height="100"> | ||
| <h1 align="center"> NoiseTorch</h1> | ||
| <h3 align="center"> Noise Supression Application for PulseAudio or Pipewire</h3> | ||
| <p align="center"><img src="https://raw.githubusercontent.com/noisetorch/NoiseTorch/master/assets/icon/noisetorch.png" width="100" height="100"></p> | ||
|
|
||
| # NoiseTorch | ||
| [](https://www.gnu.org/licenses/gpl-3.0) [](https://github.com/noisetorch/NoiseTorch/releases) | ||
|
|
||
| [](https://www.gnu.org/licenses/gpl-3.0) | ||
| [](https://github.com/noisetorch/NoiseTorch/releases) | ||
|
|
||
| ## Probable insecurity / remove NoiseTorch | ||
| NoiseTorch is an easy to use open source application for Linux with PulseAudio or PipeWire. It creates a virtual microphone that suppresses noise, in any application. Use whichever conferencing or VOIP application you like and simply select the NoiseTorch Virtual Microphone as input to torch the sound of your mechanical keyboard, computer fans, trains and the likes. | ||
|
|
||
| At least one of the original developers' (@lawl) systems has probably been compromised. Due to that we currently can not expect the source code NOR the binaries to be secure. | ||
| Therefore you should for now remove NoiseTorch from your systems, until this issue is cleared up: | ||
| Don't forget to leave a star ⭐ if this sounds useful to you! | ||
|
|
||
| ~~~ | ||
| rm ~/.local/bin/noisetorch | ||
| rm ~/.local/share/applications/noisetorch.desktop | ||
| rm ~/.local/share/icons/hicolor/256x256/apps/noisetorch.png | ||
| ~~~ | ||
| ## Screenshot | ||
|
|
||
| ## Seeking help with code review | ||
|  | ||
|
|
||
| If the community can help review ALL of the code, maybe we can trust the code again and work from there. | ||
| Then simply select NoiseTorch as your microphone in any application. OBS, Mumble, Discord, anywhere. | ||
|
|
||
|  | ||
|
|
||
| ## Demo | ||
|
|
||
| Linux For Everyone has a good demo video [here](https://www.youtube.com/watch?v=DzN9rYNeeIU). | ||
|
|
||
| ## Features | ||
| * Two click setup of your virtual denoising microphone | ||
| * A single, small, statically linked, self-contained binary | ||
|
|
||
| ## Download & Install | ||
|
|
||
| [Download the latest release from GitHub](https://github.com/noisetorch/NoiseTorch/releases). | ||
|
|
||
| Unpack the `tgz` file, into your home directory. | ||
|
|
||
| tar -C $HOME -xzf NoiseTorch_x64.tgz | ||
|
|
||
| This will unpack the application, icon and desktop entry to the correct place. | ||
| Depending on your desktop environment you may need to wait for it to rescan for applications, or tell it to do a refresh now. | ||
|
|
||
| With gnome this can be done with: | ||
|
|
||
| gtk-update-icon-cache | ||
|
|
||
| You now have a `noisetorch` binary and desktop entry on your system. | ||
|
|
||
| Give it the required permissions with `setcap`: | ||
|
|
||
| sudo setcap 'CAP_SYS_RESOURCE=+ep' ~/.local/bin/noisetorch | ||
|
|
||
| If noisetorch doesn't start after installation, you may also have to make sure that `~/.local/bin` is in your PATH. On most distributions e.g. Ubuntu, this should be the case by default. If it's not, make sure to append | ||
|
|
||
| ``` | ||
| if [ -d "$HOME/.local/bin" ] ; then | ||
| PATH="$HOME/.local/bin:$PATH" | ||
| fi | ||
| ``` | ||
|
|
||
| to your `~/.profile`. If you do already have that, you may have to log in and out for it to actually apply if this is the first time you're using `~/.local/bin`. | ||
|
|
||
| #### Uninstall | ||
|
|
||
| rm ~/.local/bin/noisetorch | ||
| rm ~/.local/share/applications/noisetorch.desktop | ||
| rm ~/.local/share/icons/hicolor/256x256/apps/noisetorch.png | ||
|
|
||
| ## Troubleshooting | ||
|
|
||
| Please see the [Troubleshooting](https://github.com/noisetorch/NoiseTorch/wiki/Troubleshooting) section in the wiki. | ||
|
|
||
| ## Usage | ||
|
|
||
| Select the microphone you want to denoise, and click "Load NoiseTorch", NoiseTorch will create a virtual microphone called "NoiseTorch Microphone" that you can select in any application. Output filtering works the same way, simply output the applications you want to filter to "NoiseTorch Headphones". | ||
|
|
||
| When you're done using it, simply click "Unload NoiseTorch" to remove it again, until you need it next time. | ||
|
|
||
| The slider "Voice Activation Threshold" under settings, allows you to choose how strict NoiseTorch should be in only allowing your microphone to send sounds when it detects voice.. Generally you want this up as high as possible. With a decent microphone, you can turn this to the maximum of 95%. If you cut out during talking, slowly lower this strictness until you find a value that works for you. | ||
|
|
||
| If you set this to 0%, NoiseTorch will still dampen noise, but not deactivate your microphone if it doesn't detect voice. | ||
|
|
||
| Please keep in mind that you will need to reload NoiseTorch for these changes to apply. | ||
|
|
||
| Once NoiseTorch has been loaded, feel free to close the window, the virtual microphone will continue working until you explicitly unload it. The NoiseTorch process is not required anymore once it has been loaded. | ||
|
|
||
| ## Latency | ||
|
|
||
| NoiseTorch may introduce a small amount of latency for microphone filtering. The amount of inherent latency introduced by noise supression is 10ms, this is very low and should not be a problem. Additionally PulseAudio currently introduces a variable amount of latency that depends on your system. Lowering this latency [requires a change in PulseAudio](https://gitlab.freedesktop.org/pulseaudio/pulseaudio/-/issues/120). | ||
|
|
||
| Output filtering currently introduces something on the order of ~100ms with pulseaudio. This should still be fine for regular conferences, VOIPing and gaming. Maybe not for competitive gaming teams. | ||
|
|
||
| ## Building from source | ||
|
|
||
| Install the Go compiler from [golang.org](https://golang.org/). And make sure you have a working C++ compiler. | ||
|
|
||
| ```shell | ||
| git clone https://github.com/noisetorch/NoiseTorch # Clone the repository | ||
| cd NoiseTorch # cd into the cloned repository | ||
| make # build it | ||
| ``` | ||
|
|
||
| ## Special thanks to | ||
|
|
||
| * [@lawl](https://github.com/lawl) Creator of NoiseTorch | ||
| * [xiph.org](https://xiph.org)/[Mozilla's](https://mozilla.org) excellent [RNNoise](https://jmvalin.ca/demo/rnnoise/). | ||
| * [@werman](https://github.com/werman/)'s [noise-suppression-for-voice](https://github.com/werman/noise-suppression-for-voice/) for the inspiration | ||
| * [@aarzilli](https://github.com/aarzilli/)'s [nucular](https://github.com/aarzilli/nucular) GUI toolkit for Go. | ||
| * [Sallee Design](https://www.salleedesign.com) (info@salleedesign.com)'s Microphone Icon under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) | ||
|
|
||
| To help go here to read up on the history: https://github.com/noisetorch/NoiseTorch/discussions/264 | ||
| ... and here to check what still needs to be done: https://github.com/noisetorch/NoiseTorch/discussions/275 |