qwertyzipe/swearbeeper

SwearBeeper is a Windows application that listens to a microphone and automatically bleeps out swear words in Russian speech, in close to real time. It works by capturing audio into a buffer, running a copy of the sound through an offline speech recognition engine called Vosk, and checking the recognized words against a list of swear word roots and prefixes. If a match is found, a beep or a random custom sound is layered over that part of the audio before it reaches the output, using a short delay of about one to two seconds to make the timing work. Because recognition happens entirely offline through Vosk, no audio is sent over the internet. The tool is aimed at people doing livestreams, recording podcasts, or making calls on Discord who want profanity automatically muted without editing audio by hand. Users can customize the delay length, beep volume, padding around each detected word, and a whitelist of words to exclude, and they can add their own list of banned words directly in the interface. There is also support for swapping in custom .wav sounds instead of a plain beep. Beyond censoring, SwearBeeper tracks statistics: a running count of swear words caught in the current session and over all time, a ranking table of the most frequent words, and a timestamped log. It includes a system tray icon, a global hotkey to mute or unmute, a microphone level meter, and settings that save automatically. A companion OBS script connects over a local socket to show a live swear counter, a censorship banner, and a timer counting how long it has been since the last detected word. The author notes this relies on word matching rather than a precise AI classifier, so it can miss some words or trigger on others by mistake, and results depend on microphone quality and background noise. Running it requires Windows, Python 3.12, and a downloaded Vosk speech model for Russian. The project is released under the MIT license.