From b3c2a8b9fd8b96ac946244393af114eacec3e7b0 Mon Sep 17 00:00:00 2001
From: Sucukdeluxe <259325684+Sucukdeluxe@users.noreply.github.com>
Date: Mon, 10 Aug 2026 19:25:08 +0200
Subject: [PATCH] release: publish Twitch VOD Manager 1.0.3
Polish navigation, settings, streamer and queue workflows; add safe pause and partial-file lifecycle handling; apply the product identity across Windows surfaces; and replace the public README with a complete English product guide and isolated screenshot.
---
.gitignore | 2 +
CHANGELOG.md | 14 +
README.md | 128 ++-
build/icon.ico | Bin 0 -> 370418 bytes
build/icon.png | Bin 0 -> 387339 bytes
docs/images/twitch-vod-manager-overview.png | Bin 0 -> 251704 bytes
package-lock.json | 4 +-
package.json | 9 +-
scripts/capture-readme-screenshot.js | 101 ++
scripts/dev.mjs | 102 ++
scripts/public-release-files.json | 17 +
scripts/smoke-test-full.js | 6 +
scripts/smoke-test-public-release-config.js | 21 +-
scripts/smoke-test-template-guide.js | 3 +
scripts/smoke-test-workspace-ui.js | 1007 ++++++++++++++++++-
src/index.html | 414 ++++----
src/main.ts | 421 +++++---
src/main/dev-executable.test.ts | 41 +
src/main/dev-executable.ts | 71 ++
src/main/dev-reload.test.ts | 17 +
src/main/dev-reload.ts | 31 +
src/main/domain/app-identity.test.ts | 15 +
src/main/domain/app-identity.ts | 13 +
src/main/domain/i18n-backend.test.ts | 8 +
src/main/domain/i18n-backend.ts | 22 +-
src/main/domain/migrator.ts | 2 +-
src/main/domain/partial-download.test.ts | 64 ++
src/main/domain/partial-download.ts | 83 ++
src/main/domain/pausable-output.test.ts | 89 ++
src/main/domain/pausable-output.ts | 74 ++
src/main/domain/vod-preview.test.ts | 19 +
src/main/domain/vod-preview.ts | 20 +
src/main/infra/loopback-server.ts | 2 +-
src/preload.ts | 4 +
src/renderer-globals.d.ts | 7 +
src/renderer-locale-de.ts | 247 ++---
src/renderer-locale-en.ts | 23 +-
src/renderer-profile.ts | 69 +-
src/renderer-queue.ts | 108 +-
src/renderer-settings.ts | 73 +-
src/renderer-streamers.ts | 483 ++++++---
src/renderer-texts.ts | 22 +-
src/renderer-updates.ts | 4 +
src/renderer-vod-hover.ts | 33 +-
src/renderer.ts | 124 ++-
src/styles.css | 124 +--
src/types.ts | 1 +
src/workspace.css | 719 ++++++++++++-
48 files changed, 4035 insertions(+), 826 deletions(-)
create mode 100644 build/icon.ico
create mode 100644 build/icon.png
create mode 100644 docs/images/twitch-vod-manager-overview.png
create mode 100644 scripts/capture-readme-screenshot.js
create mode 100644 scripts/dev.mjs
create mode 100644 src/main/dev-executable.test.ts
create mode 100644 src/main/dev-executable.ts
create mode 100644 src/main/dev-reload.test.ts
create mode 100644 src/main/dev-reload.ts
create mode 100644 src/main/domain/app-identity.test.ts
create mode 100644 src/main/domain/app-identity.ts
create mode 100644 src/main/domain/partial-download.test.ts
create mode 100644 src/main/domain/partial-download.ts
create mode 100644 src/main/domain/pausable-output.test.ts
create mode 100644 src/main/domain/pausable-output.ts
create mode 100644 src/main/domain/vod-preview.test.ts
create mode 100644 src/main/domain/vod-preview.ts
diff --git a/.gitignore b/.gitignore
index 882a58a..c41dfa1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,4 +8,6 @@ tmp_*/
.env
.env.*
!.env.example
+.dev-program-data/
+.dev-user-data/
.DS_Store
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9eac2f6..a95cb0b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,19 @@
# Changelog
+## 1.0.3 - 2026-08-10
+
+- Added animated selection markers across the main navigation, sidebar modes, language control, streamer list and settings pages.
+- Reorganized Settings into dedicated pages with a responsive two-column download configuration and clearer public-mode guidance.
+- Added startup preloading and silent five-minute background refreshes for configured streamers and their VOD libraries.
+- Improved VOD cards with stable one-line titles, localized dates, clearer view counts, persistent duration badges and high-resolution hover previews.
+- Added an optional split Streamer and Queue sidebar, compact streamer context actions and space-efficient merge-order selection.
+- Improved queue accuracy with real zero-percent starts, stable progress metadata and pause or continue support without restarting the download.
+- Added safe partial-file handling so incomplete downloads are removed after cancellation, normal shutdown or crash recovery and final names only appear after verification.
+- Replaced Electron branding across the window, taskbar, installer, uninstaller and notifications with the Twitch VOD Manager identity.
+- Improved German localization, date formatting, text-selection behavior, responsive navigation labels and update-dialog layout.
+- Added a Windows hot-reload development workflow for renderer and main-process changes.
+- Updated the public documentation with a complete feature overview, privacy details, setup guidance and an isolated product screenshot.
+
## 1.0.2 - 2026-08-10
- Redesigned the desktop workspace with compact top navigation, contextual sidebars and dedicated toolbars for all seven areas.
diff --git a/README.md b/README.md
index 088e07f..2e51e84 100644
--- a/README.md
+++ b/README.md
@@ -1,40 +1,130 @@
-# Twitch VOD Manager
+
+

-Twitch VOD Manager is a Windows desktop application for finding, downloading, trimming, splitting, merging and organizing Twitch VODs and clips.
+ # Twitch VOD Manager
-## Features
+ A focused Windows desktop app for browsing, downloading, trimming, merging and organizing Twitch VODs and clips.
-- Search streamers and browse available VODs
-- Download complete VODs or precise time ranges
-- Split long recordings into configurable parts
-- Merge related downloads and track group progress
-- Resume interrupted downloads and verify completed files
-- Manage queues, history, profiles and per-streamer automation
-- Capture live streams and Twitch chat
-- Navigate a compact workspace with contextual sidebars and dedicated toolbars
-- Use Light, Dark and System themes with German and English localization
-- Search settings and jump directly to individual configuration areas
-- Receive application updates through GitHub Releases
+ [](https://github.com/Sucukdeluxe/Twitch-VOD-Manager/releases/latest)
+ [](https://github.com/Sucukdeluxe/Twitch-VOD-Manager/releases/latest)
+ [](LICENSE)
+
+ [Download for Windows](https://github.com/Sucukdeluxe/Twitch-VOD-Manager/releases/latest)
+
+
+
+
+## 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
+- Trim, 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
-Download the current Windows installer from [GitHub Releases](https://github.com/Sucukdeluxe/Twitch-VOD-Manager/releases/latest).
+1. Open the [latest GitHub release](https://github.com/Sucukdeluxe/Twitch-VOD-Manager/releases/latest).
+2. Download `Twitch-VOD-Manager-Setup-1.0.3.exe`.
+3. Run the installer and choose the installation directory.
+4. Start Twitch VOD Manager and add a streamer.
-The application stores its settings and local database on the computer where it is installed. No Twitch credentials, user settings, download history or personal data are included in this repository or its release files.
+The current Windows installer is not code-signed, so Microsoft Defender SmartScreen may ask for confirmation before the first installation.
+
+## Getting started
+
+1. Select **Twitch VODs** and choose **Add streamer**.
+2. Enter a Twitch channel name.
+3. Select a VOD card with a click, or right-click it to open the broadcast on Twitch.
+4. Choose **+ Queue** for a complete download or **Trim VOD** for a time range.
+5. 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:
+### Requirements
- Node.js 22.13 or newer
-- Windows for building the NSIS installer
+- npm
+- Windows for NSIS installer builds
+
+### Run with hot reload
```powershell
npm ci
+npm run dev
+```
+
+Renderer changes reload automatically. Main-process changes restart the development application.
+
+### Verify and build
+
+```powershell
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 and desktop integrations |
+| `src/main/` | Domain logic, persistence and infrastructure |
+| `src/renderer-*.ts` | Workspace features and renderer behavior |
+| `src/index.html` | Application shell and settings pages |
+| `src/styles.css` | Shared component styles |
+| `src/workspace.css` | Desktop workspace layout and motion |
+| `scripts/` | Development, test and release checks |
+| `build/` | Installer resources and application icons |
+
## License
-Twitch VOD Manager is available under the [MIT License](LICENSE).
+Twitch VOD Manager is released under the [MIT License](LICENSE).
diff --git a/build/icon.ico b/build/icon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..f45cb45d70ef1b4f977539d23a1d50d4444e91de
GIT binary patch
literal 370418
zcmagH2iRU!mG^y9Z10Rpo+k-GRMIQGSV2&vD3Cx%4