Administrator/Twitch-VOD-Manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 230 Wiki Activity
Files
767866cde39e4d618af54bd434012861bbd2fb48
Twitch-VOD-Manager/PROJECT_MEMORY.md
T
Sucukdeluxe 767866cde3
Windows CI / verify (push) Canceled after 0s
Details
fix: resolve repository icon for Windows hot development
2026-09-06 12:30:23 +02:00

6.6 KiB
Raw Blame History

Twitch Downloader – Projekt-Memory

Zweck und Arbeitsstand

Windows-Desktopanwendung auf Basis von Electron und TypeScript zum Durchsuchen, Herunterladen, Schneiden, Zusammenfügen und Verwalten von Twitch-VODs, Clips und lokalen Videos.

Am 6. September 2026 nach einem Festplatten-Reset aus den vorhandenen Remote-Repositories wiederhergestellt. Der lokale Projektordner heißt Twitch Downloader. Die Anwendung, Paketkennung, Installer, Update-Adressen und Remote-Repositories heißen weiterhin Twitch VOD Manager beziehungsweise Twitch-VOD-Manager. Die vollständige Produktumbenennung ist noch offen.

Git und maßgeblicher Stand

  • Arbeitsbranch: public-v1, Tracking: origin/public-v1.
  • origin: https://github.com/Sucukdeluxe/Twitch-VOD-Manager.git (bestehendes öffentliches Repository).
  • forgejo: https://git.24-music.de/Administrator/Twitch-VOD-Manager.git.
  • Wiederhergestellte Basis: 35364ca5880ef96e365b65fe55b769d60455972a, Tag v1.0.19, 14. August 2026. Beide Remotes hatten auf public-v1 exakt diesen Commit.
  • GitHubs Standardbranch main ist veraltet: 5113089, Version 1.0.9. Forgejos main und feat/v5-foundation gehören zu älteren Entwicklungslinien vom Mai 2026. Deren größere Versionsnummern kennzeichnen keinen neueren Stand. Für die Fortsetzung public-v1 verwenden.
  • Forgejo ist auf diesem Rechner über HTTPS erreichbar; der geprüfte SSH-Zugriff wurde abgelehnt.
  • Zusammengehörige Änderungen prüfen, committen, zu beiden Remotes pushen und die Commit-IDs verifizieren. Ein Push ist kein Release.

Letzte Änderungen

    1. September 2026: Windows-Hot-Dev-Start repariert. Die umbenannte Electron-EXE meldet app.isPackaged auch im Entwicklungsbetrieb als wahr; die Symbolauflösung berücksichtigt nun ausdrücklich TWITCH_VOD_MANAGER_DEV und verwendet das vorhandene build/icon.ico.
  • 1.0.19: Streamlink und FFmpeg werden nach der Installation automatisch im Hintergrund eingerichtet; die Queue zeigt die Vorbereitung der Download-Werkzeuge an. Außerdem wurden instabile Electron-Smoke-Tests korrigiert.
  • 1.0.18: Reparaturen bei Werkzeuginstallation und Windows-Kurzpfaden, robustere Download- und Wiederherstellungsabläufe, Verbesserungen an Updates, Diagnosen, Queue, Streamer-Auswahl und Video-Cutter sowie zusätzliche isolierte Prüfungen.
  • 1.0.15 bis 1.0.17: bessere Einstellungsdarstellung, deutsche Diagnosetexte, System-Theme, Cutter-Wiederherstellung und begrenzte Wartezeiten beim Beenden.
  • Details stehen in CHANGELOG.md und der Git-Historie. Git stellt keine vollständigen früheren Chats, lokalen Zugangsdaten oder verlorenen Nutzerdaten wieder her.

Lokale Einrichtung und Befehle

Verifiziertes lokales Werkzeugumfeld: Node.js 24.19.0, npm 11.17.0 und PowerShell 7. Die CI verwendet Node.js 24.11.1.

Das & im übergeordneten Windows-Ordnernamen führt mit der standardmäßigen npm-Shell zu fehlerhaft ausgewerteten Befehlen. Deshalb enthält die lokale, über .git/info/exclude ausgeschlossene .npmrc den Eintrag script-shell=pwsh. Diese Einstellung bei einer erneuten Wiederherstellung im gleichen Ordner ebenfalls setzen.

Set-Content -LiteralPath .npmrc -Value 'script-shell=pwsh' -Encoding utf8
npm ci --ignore-scripts --no-audit --no-fund
node node_modules/electron/install.js
npm run build
npm run dev

npm ci mit Installationsskripten scheiterte beim automatischen node-gyp-Aufruf im Ordner mit &. Die Wiederherstellung verwendet die mitgelieferte Windows-Binärdatei von better-sqlite3; ein SQLite-Test ausschließlich im Arbeitsspeicher war erfolgreich. Electron wurde anschließend ausdrücklich installiert.

  • npm run dev: Entwicklungsstart mit Hot Reload; npm start: einmaliger Entwicklungsstart.
  • Entwicklungsdaten liegen isoliert in .dev-program-data/ und .dev-user-data/; beide Ordner sind ignoriert.
  • Basisprüfungen: npm run build, npm run lint, npm run security:check, npm run test:unit.
  • Isolierter Anwendungstest: npm run test:e2e.
  • Umfassende Release-Prüfung: npm run test:e2e:release; Windows-Paket: npm run dist:win.
  • Relevante Struktur: src/main.ts, src/main/, src/renderer-*.ts, src/index.html, src/styles*.css, src/workspace*.css, scripts/ und build/.

Entscheidungen und offene nächste Schritte

  • Zunächst den aktuellen Quellstand und die Entwicklungsumgebung wiederherstellen. Keine neue Version veröffentlichen.
  • Die gewünschte Umbenennung zu Twitch Downloader ist lokal umgesetzt. Eine Umbenennung der Remotes und der Anwendung samt Update-Kompatibilität ist gesondert abzustimmen und zu prüfen.
  • Die Standardbranches wurden bei der Wiederherstellung nicht umgestellt oder mit älteren Entwicklungslinien zusammengeführt.
  • Nächste fachliche Änderung von Sascha entgegennehmen; vor Änderungen diese Memory, README.md, CHANGELOG.md und den Git-Status lesen.
  • Keine Geheimnisse, Datenbank-Dumps, Backups oder Nutzerdaten committen. Vor schreibenden Live-Datenänderungen gelten Saschas Vorgaben zu Bestandsprüfung, verifiziertem Backup, Staging-Test und ausdrücklichem Go.

Zuletzt verifizierter Stand

  1. September 2026, wiederhergestellter Quellstand 1.0.19:
  • Abhängigkeiten und Electron installiert; SQLite ausschließlich im Arbeitsspeicher geprüft.
  • npm run build: erfolgreich.
  • npm run lint: erfolgreich mit 15 bereits vorhandenen Warnungen, keine Fehler.
  • npm run security:check: erfolgreich, keine Befunde.
  • npm run test:unit: 82 Testdateien und 630 Tests erfolgreich.
  • npm run test:e2e: erfolgreicher Electron-Start und Smoke-Test mit isolierten Datenverzeichnissen und Offline-Fixtures, keine gemeldeten Probleme.
  • PROJECT_MEMORY.md separat auf sensible Inhalte geprüft; Ignore-Regeln für Umgebungsdateien, Entwicklungsdaten, Abhängigkeiten und lokale npm-Konfiguration geprüft.
  • Kein vollständiger Release-, Installer- oder Live-Twitch-Test in dieser Wiederherstellung; keine Veröffentlichung erstellt.
  1. September 2026, anschließende Hot-Dev-Reparatur:
  • npm run build, die sechs Tests für App-Identität und Entwicklungs-EXE, npm run security:check und npm run test:e2e erfolgreich.
  • npm run lint: keine Fehler, weiterhin 15 bestehende Warnungen.
  • Tatsächlicher Start über scripts/dev.mjs mit der umbenannten Windows-EXE erfolgreich: Anwendungsfenster geöffnet, TypeScript-Watcher aktiv mit null Fehlern. Renderer-Dateien werden automatisch neu geladen; Änderungen am Main-Prozess lösen einen Neustart aus.
  • Hot-Dev läuft mit den isolierten Entwicklungsdatenverzeichnissen. Der Launcher kann im Hintergrund über Node gestartet werden; Konsolenprotokolle liegen bei diesem Start außerhalb des Repositories im Windows-Temp-Verzeichnis.
Reference in New Issue View Git Blame Copy Permalink