Skip to content

v0.1.0 — Buzz for Unraid

Choose a tag to compare

@StormAvenger StormAvenger released this 27 Oct 23:44
· 35 commits to main since this release

First public release of the unofficial Buzz desktop container for Unraid.

  • Buzz 1.4.5 opens in your browser through Unraid’s WebUI action.
  • A permanent top bar provides file uploads with progress and transcript downloads.
  • Choose only Input folder and Output folder during installation; appdata, uploads, the web port, and GPU settings are prefilled.
  • NVIDIA transcription with a CUDA 12.6 stack chosen for GTX 1080 compatibility.
  • Persistent settings, history, and models; read-only original recordings; automatic TXT, SRT, and VTT exports.

Install

Use the current Unraid template: its app name is Buzz-Transcription and new installs use /mnt/user/appdata/buzz-transcription, avoiding the unrelated Buzz collaboration app. This template update does not change the image. Existing installations retain their saved mappings; see the README before installing both apps on one server.

Requires an amd64 Unraid server, a compatible NVIDIA GPU, and the NVIDIA Driver plugin. Follow the README for installation and folder permissions.

Versioned image: ghcr.io/stormavenger/buzz-unraid:0.1.0
Stable update channel: ghcr.io/stormavenger/buzz-unraid:latest

Both tags identify sha256:60479faefdfd217d387446d69fbbab997fbf3fda8110626835dd1c2acab3da55.

The publication workflow passed. Inventory, notices, matching sources, checksums, and the image scan are attached below. Download SOURCE-README.txt for source archive instructions.

Validation

Linux amd64 build, real audio decoding/resampling, application startup, and storage persistence checks passed. The release candidate transcribed the public test recording offline with Faster Whisper Small on a GTX 1080 using int8_float32. The release scan found zero HIGH or CRITICAL findings; 645 MEDIUM and 32 LOW findings remain in image-scan.json. Matching-source collection completed with 1,064 archives and no failures.

Scope

This is a shared, single-user browser desktop for a trusted LAN or VPN. After uploading a recording, import it with Buzz’s + button from /uploads. Microphone forwarding is not configured. Faster Whisper is the validated default; NeMo, larger models, speaker identification, speech separation, and other GPU families need separate testing.

Container-specific code and original assets use MIT. Bundled components retain their own licenses; see THIRD_PARTY_NOTICES.md, docs/REDISTRIBUTION.md, and the release records. Model weights are downloaded separately and retain their own terms.

Archived validation details

Moved from docs/VALIDATION.md on October 28, 2026. These are historical results; stable-tag and catalog statements describe the time of the original checks.

Tested configuration

  • Unraid 7.3.4 (initial development tests used 7.3.3); Ryzen 7 1800X.
  • NVIDIA GTX 1080, 8192 MiB, with the Unraid NVIDIA Driver plugin.
  • Buzz 1.4.5; Python 3.12; PyTorch 2.8.0+cu126; Faster Whisper 1.2.1; CTranslate2 4.6.2.

Completed

  • Host tests cover precision selection, export routing, upstream patch drift, browser/application health, process exit races, Unraid mappings, direct-wheel hash structure, and blocked runtime package installation.
  • All six guarded compatibility changes apply to the pinned Buzz/Faster Whisper packages, and modified Python files parse. Mono and stereo WAV decoding/resampling is exercised during the image build.
  • Python/shell syntax and XML/YAML parsing pass. The runtime and build dependency locks include artifact hashes.
  • The Linux image built on the Unraid server. The application check runs in the final runtime stage, including its shared Python library, without build-only libraries available.
  • The disposable CPU smoke test passed: browser readiness, Buzz window creation, writable folders as UID 99/GID 100, and files surviving a restart.
  • The Unraid template created a healthy buzz container; its WebUI action opened the browser desktop.
  • Real CUDA matrix computation passed on the GTX 1080. CTranslate2 reports float32, int8, and int8_float32 GPU compute types.
  • A public Whisper test recording was uploaded using the browser file manager, imported in Buzz, and transcribed with Faster Whisper Small in approximately 10 seconds. Container logs reported CUDA 12.6. TXT/SRT/VTT files were created in the mapped output folder as nobody:users.
  • Remote Resizing made the desktop fit the browser window.
  • On Unraid 7.3.4, the browser toolbar opened the uploads folder and transcript folder directly. Chrome downloaded a completed TXT transcript successfully. Both a 32 KB WAV and an 8 MiB WAV uploaded through the top-bar picker with matching SHA-256 hashes on the server; progress was visible for the larger upload.
  • Recreating the container with the toolbar image and existing folder mappings preserved the saved transcription history and output files. The replacement container became healthy.

The GitHub Linux check passed for release commit c3cb6ebd072395c236ccf48b3d3e0ff3e2761d48. All 16 host tests, Docker build-context privacy checks, Compose validation, the Linux amd64 image build, and the disposable CPU/browser/persistent-storage smoke test passed on the hosted Ubuntu runner. GPU inference was verified separately on the Unraid server, using a cached Small model and the public JFK sample with networking disabled.

The publication workflow completed the clean-image inventory and matching-source collection: 285 Python packages, 330 Ubuntu packages, and 1,064 source archives with no collection failures. Its Trivy report contained no HIGH or CRITICAL findings; 645 MEDIUM and 32 LOW findings remain visible in the report. This is a point-in-time scan, not a guarantee that the image has no vulnerabilities. The matching release assets are public.

The official Community Applications scan passed: one valid Docker app, no hard errors or template warnings, and a publicly pullable image. The submission was sent and auto-approved on October 27, 2026. Catalog visibility awaits the next Community Applications build.

v0.1.0 image digest (the initial stable release): sha256:60479faefdfd217d387446d69fbbab997fbf3fda8110626835dd1c2acab3da55.

An anonymous pull using an empty Docker credential configuration succeeded on the Unraid server and matched that digest. The exact published image passed CUDA computation and offline Faster Whisper Small inference on the GTX 1080. The existing installation was switched to the public stable tag with its original storage mappings; it became healthy and the browser desktop retained its saved history. Unraid's Auto Update Applications plugin recognizes the public image and retains the selected-container update schedule.