Metadata-Version: 2.4
Name: buzz-captions
Version: 1.4.4
Author-email: Chidi Williams <williamschidi1@gmail.com>
License: MIT
License-File: LICENSE
Requires-Python: <3.13,>=3.12
Requires-Dist: accelerate<2,>=1.12.0
Requires-Dist: bitsandbytes>=0.45.0; sys_platform != 'darwin' or platform_machine != 'x86_64'
Requires-Dist: certifi==2025.11.12
Requires-Dist: cmake<5,>=4.2.0
Requires-Dist: coverage==7.12.0
Requires-Dist: ctranslate2<5,>=4.6.2; sys_platform != 'darwin'
Requires-Dist: ctranslate2<5,>=4.6.2; sys_platform == 'darwin' and platform_machine == 'arm64'
Requires-Dist: ctranslate2==4.3.1; sys_platform == 'darwin' and platform_machine == 'x86_64'
Requires-Dist: darkdetect<0.9,>=0.8.0
Requires-Dist: dataclasses-json<0.7,>=0.6.4
Requires-Dist: datasets>=4.4.1
Requires-Dist: diffq<0.3,>=0.2.4
Requires-Dist: dora-search<0.2,>=0.1.12
Requires-Dist: einops<0.9,>=0.8.1
Requires-Dist: faster-whisper<2,>=1.2.1
Requires-Dist: flake8<8,>=7.1.2
Requires-Dist: hatchling>=1.28.0
Requires-Dist: hf-xet<2,>=1.1.5
Requires-Dist: humanize<5,>=4.4.0
Requires-Dist: hydra-colorlog<2,>=1.2.0
Requires-Dist: hydra-core<2,>=1.3.2
Requires-Dist: julius<0.3,>=0.2.7
Requires-Dist: keyring<26,>=25.0.0
Requires-Dist: lameenc<2,>=1.8.1
Requires-Dist: lhotse==1.32.1
Requires-Dist: museval<0.5,>=0.4.1
Requires-Dist: mypy<2,>=1.15.0
Requires-Dist: nemo-toolkit[asr]==2.5.3; sys_platform != 'darwin' or platform_machine != 'x86_64'
Requires-Dist: nltk>=3.9.2
Requires-Dist: numpy<2,>=1.21.2
Requires-Dist: nvidia-cudnn-cu12<10,>=9; sys_platform != 'darwin'
Requires-Dist: onnx>=1.20.0
Requires-Dist: onnxruntime==1.18.1
Requires-Dist: openai-whisper==20250625
Requires-Dist: openai<2,>=1.14.2
Requires-Dist: openunmix<2,>=1.3.0
Requires-Dist: peft<1,>=0.14.0
Requires-Dist: platformdirs<5,>=4.2.1
Requires-Dist: polib<2,>=1.2.0
Requires-Dist: posthog<4,>=3.23.0
Requires-Dist: pyqt6-qt6==6.9.1
Requires-Dist: pyqt6-sip==13.10.2
Requires-Dist: pyqt6==6.9.1
Requires-Dist: pyyaml<7,>=6.0.2
Requires-Dist: requests<3,>=2.31.0
Requires-Dist: sounddevice<0.6,>=0.5.3
Requires-Dist: soundfile<0.14,>=0.13.1
Requires-Dist: srt-equalizer<0.2,>=0.1.10
Requires-Dist: stable-ts<3,>=2.19.1
Requires-Dist: submitit<2,>=1.5.2
Requires-Dist: torch==2.2.2; sys_platform == 'darwin' and platform_machine == 'x86_64'
Requires-Dist: torch==2.8.0; sys_platform != 'darwin'
Requires-Dist: torch==2.8.0; sys_platform == 'darwin' and platform_machine == 'arm64'
Requires-Dist: torch>=2.2.2
Requires-Dist: torchaudio==2.2.2; sys_platform == 'darwin' and platform_machine == 'x86_64'
Requires-Dist: torchaudio==2.8.0; sys_platform != 'darwin'
Requires-Dist: torchaudio==2.8.0; sys_platform == 'darwin' and platform_machine == 'arm64'
Requires-Dist: torchaudio>=2.2.2
Requires-Dist: torchcodec>=0.9.0; sys_platform != 'darwin' or platform_machine != 'x86_64'
Requires-Dist: tqdm<5,>=4.67.1
Requires-Dist: transformers<5,>=4.53
Requires-Dist: treetable<0.3,>=0.2.5
Requires-Dist: urllib3<3,>=2.6.0
Requires-Dist: uroman>=1.3.1.1
Requires-Dist: vulkan<2,>=1.3.275.1
Requires-Dist: yt-dlp>=2026.2.21
Description-Content-Type: text/markdown

[[简体中文](readme/README.zh_CN.md)] <- 点击查看中文页面。

# Buzz

[Documentation](https://chidiwilliams.github.io/buzz/)

Transcribe and translate audio offline on your personal computer. Powered by
OpenAI's [Whisper](https://github.com/openai/whisper).

![MIT License](https://img.shields.io/badge/license-MIT-green)
[![CI](https://github.com/chidiwilliams/buzz/actions/workflows/ci.yml/badge.svg)](https://github.com/chidiwilliams/buzz/actions/workflows/ci.yml)
[![codecov](https://codecov.io/github/chidiwilliams/buzz/branch/main/graph/badge.svg?token=YJSB8S2VEP)](https://codecov.io/github/chidiwilliams/buzz)
![GitHub release (latest by date)](https://img.shields.io/github/v/release/chidiwilliams/buzz)
[![Github all releases](https://img.shields.io/github/downloads/chidiwilliams/buzz/total.svg)](https://GitHub.com/chidiwilliams/buzz/releases/)

![Buzz](https://raw.githubusercontent.com/chidiwilliams/buzz/refs/heads/main/buzz/assets/buzz-banner.jpg)

## Features
- Transcribe audio and video files or Youtube links
- Live realtime audio transcription from microphone
  - Presentation window for easy accessibility during events and presentations
- Speech separation before transcription for better accuracy on noisy audio
- Speaker identification in transcribed media
- Multiple whisper backend support
  - CUDA acceleration support for Nvidia GPUs
  - Apple Silicon support for Macs
  - Vulkan acceleration support for Whisper.cpp on most GPUs, including integrated GPUs
- Export transcripts to TXT, SRT, and VTT
- Advanced Transcription Viewer with search, playback controls, and speed adjustment
- Keyboard shortcuts for efficient navigation
- Watch folder for automatic transcription of new files
- Command-Line Interface for scripting and automation

## Installation

### macOS

Download the `.dmg` from the [SourceForge](https://sourceforge.net/projects/buzz-captions/files/).

### Windows

Get the installation files from the [SourceForge](https://sourceforge.net/projects/buzz-captions/files/).

App is not signed, you will get a warning when you install it. Select `More info` -> `Run anyway`.

### Linux

Buzz is available as a [Flatpak](https://flathub.org/apps/io.github.chidiwilliams.Buzz) or a [Snap](https://snapcraft.io/buzz). 

To install flatpak, run:
```shell
flatpak install flathub io.github.chidiwilliams.Buzz
```

[![Download on Flathub](https://flathub.org/api/badge?svg&locale=en)](https://flathub.org/en/apps/io.github.chidiwilliams.Buzz)

To install snap, run:
```shell
sudo apt-get install libportaudio2 libcanberra-gtk-module libcanberra-gtk3-module
sudo snap install buzz
```

[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/buzz)

### PyPI

Install [ffmpeg](https://www.ffmpeg.org/download.html)

Ensure you use Python 3.12 environment.

Install Buzz

```shell
pip install buzz-captions
python -m buzz
```

**GPU support for PyPI**

To have GPU support for Nvidia GPUS on Windows, for PyPI installed version ensure, CUDA support for [torch](https://pytorch.org/get-started/locally/) 

```
pip3 install -U torch==2.8.0+cu129 torchaudio==2.8.0+cu129 --index-url https://download.pytorch.org/whl/cu129
pip3 install nvidia-cublas-cu12==12.9.1.4 nvidia-cuda-cupti-cu12==12.9.79 nvidia-cuda-runtime-cu12==12.9.79 --extra-index-url https://pypi.ngc.nvidia.com
```

### Latest development version

For info on how to get latest development version with latest features and bug fixes see [FAQ](https://chidiwilliams.github.io/buzz/docs/faq#9-where-can-i-get-latest-development-version).

### Support Buzz

You can help the Buzz by starring 🌟 the repo and sharing it with your friends.

### Screenshots

<div style="display: flex; flex-wrap: wrap;">
    <img alt="File import" src="https://github.com/chidiwilliams/buzz/raw/main/share/screenshots/buzz-1-import.png" style="max-width: 18%; margin-right: 1%;" />
    <img alt="Main screen" src="https://github.com/chidiwilliams/buzz/raw/main/share/screenshots/buzz-2-main_screen.png" style="max-width: 18%; margin-right: 1%; height:auto;" />
    <img alt="Preferences" src="https://github.com/chidiwilliams/buzz/raw/main/share/screenshots/buzz-3-preferences.png" style="max-width: 18%; margin-right: 1%; height:auto;" />
    <img alt="Model preferences" src="https://github.com/chidiwilliams/buzz/raw/main/share/screenshots/buzz-3.2-model-preferences.png" style="max-width: 18%; margin-right: 1%; height:auto;" />
    <img alt="Transcript" src="https://github.com/chidiwilliams/buzz/raw/main/share/screenshots/buzz-4-transcript.png" style="max-width: 18%; margin-right: 1%; height:auto;" />
    <img alt="Live recording" src="https://github.com/chidiwilliams/buzz/raw/main/share/screenshots/buzz-5-live_recording.png" style="max-width: 18%; margin-right: 1%; height:auto;" />
    <img alt="Resize" src="https://github.com/chidiwilliams/buzz/raw/main/share/screenshots/buzz-6-resize.png" style="max-width: 18%;" />
</div>

