https://github.com/chidiwilliams/buzz Skip to content Toggle navigation Sign up * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code + Explore + All features + Documentation + GitHub Skills + Blog * Solutions + By Plan + Enterprise + Teams + Compare all + By Solution + CI/CD & Automation + DevOps + DevSecOps + Case Studies + Customer Stories + Resources * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles + Repositories + Topics + Trending + Collections * Pricing [ ] * # In this repository All GitHub | Jump to | * No suggested jump to results * # In this repository All GitHub | Jump to | * # In this user All GitHub | Jump to | * # In this repository All GitHub | Jump to | Sign in Sign up {{ message }} chidiwilliams / buzz Public * Notifications * Fork 8 * Star 182 Buzz transcribes audio from your computer's microphones to text using OpenAI's Whisper License MIT license 182 stars 8 forks Star Notifications * Code * Issues 12 * Pull requests 1 * Actions * Security * Insights More * Code * Issues * Pull requests * Actions * Security * Insights chidiwilliams/buzz This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. main Switch branches/tags [ ] Branches Tags Could not load branches Nothing to show {{ refName }} default View all branches Could not load tags Nothing to show {{ refName }} default View all tags Name already in use A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch? Cancel Create 6 branches 14 tags Code * Clone HTTPS GitHub CLI [https://github.com/c] Use Git or checkout with SVN using the web URL. [gh repo clone chidiw] Work fast with our official CLI. Learn more. * Open with GitHub Desktop * Download ZIP Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Launching Xcode If nothing happens, download Xcode and try again. Launching Visual Studio Code Your codespace will open once ready. There was a problem preparing your codespace, please try again. Latest commit @chidiwilliams chidiwilliams Remove delay combo box (#99) ... c02a8b3 Oct 20, 2022 Remove delay combo box (#99) c02a8b3 Git stats * 115 commits Files Permalink Failed to load latest commit information. Type Name Latest commit message Commit time .github/workflows Run CI workflow on pull requests (#96) Oct 16, 2022 .vscode Add support for opening new window from menu bar (#64) Oct 13, 2022 assets Update icons (#54) Oct 11, 2022 .gitignore Add file import transcriber (#67) Oct 15, 2022 Buzz.spec Update windows build instructions (#86) Oct 16, 2022 LICENSE Create LICENSE Sep 25, 2022 Makefile Fix crashing on quit on Mac (#94) Oct 16, 2022 README.md Fix Windows installation instructions (#27) Oct 6, 2022 _whisper.py Allow cancelling model download (#72) Oct 15, 2022 buzz.png Update README image with delay Sep 27, 2022 entitlements.plist Fix audio entitlement (#53) Oct 11, 2022 gui.py Remove delay combo box (#99) Oct 19, 2022 gui_test.py Upgrade to PyQt6 (#92) Oct 16, 2022 main.py Fix crashing on quit on Mac (#94) Oct 16, 2022 main_test.py Fix multiprocessing fork crashing on Windows (#55) Oct 12, 2022 poetry.lock Upgrade to PyQt6 (#92) Oct 16, 2022 pyproject.toml Upgrade to PyQt6 (#92) Oct 16, 2022 transcriber.py Remove delay combo box (#99) Oct 19, 2022 transcriber_test.py Add file import transcriber (#67) Oct 15, 2022 View code [ ] Buzz Requirements Installation Mac (Intel) Windows Linux How to use Record audio playing from computer Build/run locally README.md Buzz Buzz MIT License CI GitHub release (latest by date) Buzz transcribes audio from your computer's microphones to text in real-time using OpenAI's Whisper. Buzz - Watch Video [6874747073] Requirements To set up Buzz, first install ffmpeg (needed to run Whisper). # on Ubuntu or Debian sudo apt update && sudo apt install ffmpeg # on MacOS using Homebrew (https://brew.sh/) brew install ffmpeg # on Windows using Chocolatey (https://chocolatey.org/) choco install ffmpeg # on Windows using Scoop (https://scoop.sh/) scoop install ffmpeg Installation To install Buzz, download the latest version for your operating system. Buzz is available on Mac (Intel), Windows, and Linux. Mac (Intel) * Download and open the *-mac.dmg file. * After the installation window opens, drag the Buzz icon into the folder to add Buzz to your Applications directory. Windows * Download and extract the *-windows.tar.gz file. * Open the Buzz.exe file Linux * Download and extract the *-unix.tar.gz file. * Open the Buzz binary file. How to use To record from a system microphone, select a model, language, task, microphone, and delay, then click Record. Model: Default: Tiny. Language: Default: English. Task: Transcribe/Translate. Default: Transcribe. Microphone: Default: System default microphone. Delay: The length of time (in seconds) Buzz waits before transcribing a new batch of recorded audio. Increasing this value will make Buzz take longer to show new transcribed text. However, shorter delays cut the audio into smaller chunks which may reduce the accuracy of the transcription. Default: 10s. For more information about the available model types, languages, and tasks, see the Whisper docs. Record audio playing from computer To record audio playing out from your computer, you'll need to install an audio loopback driver (a program that lets you create virtual audio devices). The rest of this guide will use BlackHole on Mac, but you can use other alternatives for your operating system (see LoopBeAudio, LoopBack, and Virtual Audio Cable). 1. Install BlackHole via Homebrew brew install blackhole-2ch 2. Open Audio MIDI Setup from Spotlight or from /Applications/ Utilities/Audio Midi Setup.app. Open Audio MIDI Setup from Spotlight 3. Click the '+' icon at the lower left corner and select 'Create Multi-Output Device'. Create multi-output device 4. Add your default speaker and BlackHole to the multi-output device. Screenshot of multi-output device 5. Select this multi-output device as your speaker (application or system-wide) to play audio into BlackHole. 6. Open Buzz, select BlackHole as your microphone, and record as before to see transcriptions from the audio playing through BlackHole. Build/run locally To build/run Buzz locally from source, first install the dependencies: 1. Install Poetry. 2. Install the project dependencies. poetry install Then, to run: poetry run python main.py To build: poetry run pyinstaller --noconfirm Buzz.spec About Buzz transcribes audio from your computer's microphones to text using OpenAI's Whisper Topics whisper Resources Readme License MIT license Stars 182 stars Watchers 5 watching Forks 8 forks Releases 14 v0.4.2 Latest Oct 16, 2022 + 13 releases Contributors 2 * @chidiwilliams chidiwilliams Chidi Williams * @faveoled faveoled Languages * Python 95.6% * Makefile 4.4% Footer (c) 2022 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact GitHub * Pricing * API * Training * Blog * About You can't perform that action at this time. You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.