ensureStreamlinkInstalled and ensureFfmpegInstalled forced a managed reinstall whenever a bundled tool directory existed without passing manifest verification. When that reinstall failed (offline, blocked download, locked executable), both functions returned false without ever probing the tool that was already present and runnable, so every download path aborted with an auto-install error while the System Check kept reporting the same tool as available. Both functions now fall back to the same executability probe the System Check uses after a failed managed repair, cache the verified command on success, and only report failure when nothing runnable remains. The repair attempt itself is preserved and retried on the next call. The tool archive download also registered no error handler on the HTTP response stream. A stream that failed mid-transfer settled neither the writer finish nor the writer error path, leaving the install promise pending forever and the download start hanging indefinitely. The response stream now rejects the download on error and destroys the writer. Merge group downloads reported the bare "Streamlink is missing." text while the VOD and live paths already explained the failed auto-install. All three gates now share streamlinkAutoInstallFailed, ffmpeg gained the matching ffmpegAutoInstallFailed message, and the now unused streamlinkMissing and ffmpegMissing keys were removed. The Managed tools panel showed "Missing / Unverified" with no hint that downloads still work through a system-provided installation, which reads like a hard failure on machines that never installed the managed copies. getManagedToolStatuses now reports per tool whether a runnable installation answers the version probe, and the panel appends a localized "Downloads still available" note whenever an unverified state is covered by a working tool.
Twitch VOD Manager
A focused Windows desktop app for browsing, downloading, trimming, merging and organizing Twitch VODs and clips.
Overview
Twitch VOD Manager brings the complete VOD workflow into one desktop workspace. Add streamers, browse their public broadcasts, queue complete videos or precise ranges, and keep downloaded files organized without switching between separate tools.
The application works in public mode without a Twitch login. Connecting a Twitch account is optional and enables access to content available to that account, including eligible subscriber-only or channel-management VODs.
Highlights
Browse and organize
- Add multiple streamers and preload their profiles and VOD libraries at startup
- Refresh content quietly in the background every five minutes
- Search, sort and filter VODs with stable cards and localized metadata
- Preview high-resolution frames without leaving the application
- Track completed downloads in the archive and review aggregate statistics
Download and process
- Download complete VODs or selected time ranges
- Edit local videos with frame-accurate trimming, removable ranges, timeline zoom, waveform guidance and undo or redo
- Split and merge recordings with dedicated tools
- Queue multiple jobs and follow real progress, speed and remaining time
- Pause and continue an active download without restarting it
- Save optional chat replays and stream events alongside recordings
- Record live streams automatically with retry and merge controls
Desktop experience
- Compact navigation with animated selection states
- Separate settings pages for appearance, Twitch, downloads, automation, storage, maintenance, updates and diagnostics
- Light, Dark and System themes
- English and German interface languages
- Optional split Streamer and Queue sidebar
- Command palette and keyboard-friendly controls
- Integrated update checks through verified GitHub release assets
Reliable file handling
- Active downloads are written to temporary partial files
- Final filenames appear only after a successful integrity check
- Cancelled jobs and normal application shutdowns remove incomplete files
- Stale partial files left by a crash are cleaned up on the next launch
- Application data, settings and download history remain local
Installation
- Open the latest GitHub release.
- Download
Twitch-VOD-Manager-Setup-1.0.18.exe. - Run the installer and choose the installation directory.
- Start Twitch VOD Manager and add a streamer.
The current Windows installer is not code-signed, so Microsoft Defender SmartScreen may ask for confirmation before the first installation.
Getting started
- Select Twitch VODs and choose Add streamer.
- Enter a Twitch channel name.
- Select a VOD card with a click, or right-click it to open the broadcast on Twitch.
- Choose + Queue for a complete download or Trim VOD for a time range.
- Review the Queue in the sidebar and start the download.
Public VODs are available immediately. Twitch authentication can be configured under Settings → Twitch API when account-specific access is needed.
Data and privacy
Twitch VOD Manager stores its configuration, local database, queue state and history on the computer where it runs. OAuth credentials are handled through the local application flow and are never included in this repository or in release files.
Public mode does not require a Twitch login. It supports public VOD discovery and downloads, while authenticated access depends on the permissions of the connected Twitch account.
Updates
The application checks GitHub Releases for newer versions. The Update control only appears when an update is actually available. Every release includes latest.yml, the Windows installer and its blockmap for the desktop updater.
Development
Requirements
- Node.js 22.13 or newer
- npm
- Windows for NSIS installer builds
Run with hot reload
npm ci
npm run dev
Renderer changes reload automatically. Main-process changes restart the development application.
Verify and build
npm run test:e2e:release
npm run dist:win
The Windows installer and updater metadata are written to release/.
Project structure
| Path | Purpose |
|---|---|
src/main.ts |
Electron main-process orchestration and desktop integrations |
src/main/queue/ |
Queue process lifecycle and runtime coordination |
src/main/cutter/ |
Video cutter integration surface |
src/main/twitch/ |
Twitch authentication and provider integration |
src/main/updates/ |
Update lifecycle coordination |
src/main/storage/ |
Persistence integration surface |
src/main/domain/ |
Shared domain logic and validation |
src/renderer-*.ts |
Workspace features and renderer behavior |
src/index.html |
Application shell and settings pages |
src/styles*.css |
Shared components, workflows and overlays |
src/workspace*.css |
Desktop workspace layout, motion and responsive refinements |
scripts/ |
Development, test and release checks |
build/ |
Installer resources and application icons |
License
Twitch VOD Manager is released under the MIT License.
