Skip to content

basic v0.1.0 — first release of the simplified edition

Choose a tag to compare

@Milomilo777 Milomilo777 released this 23 May 15:50

Whisper Project — basic v0.1.0

First release of the basic edition — a radically simplified
fork of the full-fat Whisper Project. One screen, great defaults,
no airplane-dashboard of options.

This release ships as a single Windows installer with an embedded
Python interpreter (no system Python required, no Portable EXE).

What it does

  • Transcribe — drag-and-drop or Browse a media file, click
    Transcribe. Runs faster-whisper
    large-v3 locally. Writes .srt, .json, and .txt next to
    the source.
  • Language picker — Auto-detect (default), English, Chinese,
    or Vietnamese. Anything else still works via auto-detect.
  • Download Videos (optional) — paste one URL per line; the
    bundled yt-dlp.exe (or the SMTV scraper for Supreme Master TV
    URLs) downloads to your chosen folder. Optional time-range
    slice; optional auto-transcribe after download.
  • Cancel any running job (Esc or right-click).
  • Hardware autodetect — CUDA when available, otherwise CPU.

What it doesn't do (by design)

  • No tabs, no Advanced dialog, no theme switcher.
  • No transcript viewer / search / history / watched folder / tray.
  • No diarisation, chapters, voiceprint, LLM, Demucs, alignment.
  • No alternative backends (whisper.cpp, Parakeet) — only
    faster-whisper.
  • No DOCX / PDF / LRC / VTT / TSV writers.
  • No sponsorblock / subtitle download / burn-in.

For any of those, use the full-fat repo's
chore/cleanup-hardening
branch.

Self-diagnostics

If anything misbehaves:

  • Help → Diagnose — re-runs the startup checks; copy the
    report to clipboard.
  • Help → Show recent log — last 200 lines of the app log.
  • Help → Open log folder — opens the OS file manager on
    %LOCALAPPDATA%\WhisperProjectBasic\Logs\.
  • Unhandled exceptions surface a crash dialog with full
    traceback + Copy + Open log folder buttons — never silent.

Install

  1. Download WhisperProjectBasic-v0.1.0-Setup.exe from the
    Assets below.
  2. Double-click; click Yes on the UAC prompt.
  3. Confirm install location (default C:\Program Files\WhisperProjectBasic\).
  4. Optionally tick "Create a desktop icon".
  5. Launch from Start Menu under Whisper Project (basic).

The first launch shows a hub-folder picker (where Whisper models
will live) — accept the default <install>\hub or pick a roomy
drive. The first Transcribe click triggers a one-off ~3 GB
model download from the CDN (MD5-verified). Subsequent launches
load the model from disk in ~15 seconds.

Quality bar

Metric Result
pyright app/ core/ 0 errors, 0 warnings, 0 informations
Unit + integration suite 998 tests passing in ~10 s
Real-file end-to-end (90 s English clip, CPU) 106 s — done event, three output files
Adversarial runtime probe 26 scenarios, 23 PASS + 3 WARN — both real WARNs fixed
Hostile code audit 39 findings catalogued, 27 fixed (7 P0 + 20 P1)

The full audit + probe reports are committed at the repo root
(DEBUG_AUDIT_BASIC.md, DEBUG_RUNTIME_BASIC.md).

Asset

File Size
WhisperProjectBasic-v0.1.0-Setup.exe ~161 MB

Uninstall via Settings → Apps → Whisper Project (basic). If
your hub folder lives outside the install dir, the uninstaller
asks before deleting your (potentially multi-GB) model files.