FojadrachiandClaude Sonnet 5
771c438257
Windows-Patch-Pakete heissen jetzt Playtube-vX.Y.Z-win64-patch.play statt .zip (technisch weiterhin ein ganz normales ZIP-Archiv - Windows/Python schauen beim Entpacken auf die Magic Bytes, nicht auf die Endung). Playtube registriert .play beim ersten Start als Windows-Dateizuordnung (HKCU, keine Admin-Rechte noetig), sodass eine manuell heruntergeladene Patchdatei per Doppelklick installiert werden kann, ohne dass Playtube selbst etwas herunterladen muss: - shortcuts.py: ensure_play_file_association() registriert ProgID + DefaultIcon + shell/open/command und stoesst SHChangeNotify an, damit die Zuordnung sofort greift. - updater.py: UpdateInstaller akzeptiert jetzt optional local_archive_path statt einer download_url und ueberspringt dann den Download komplett. - main.py: erkennt eine .play-Datei als Kommandozeilenargument (Doppelklick- Start) und uebergibt sie an MainWindow.install_local_patch(). - release.yml: Windows-Patch wird als .zip gepackt und anschliessend zu .play umbenannt; _find_platform_asset() sucht fuer Windows-Patches jetzt nach .play statt .zip. Co-Authored-By: Claude Sonnet 5 <[email protected]>
173 lines
8.5 KiB
Markdown
173 lines
8.5 KiB
Markdown
# Playtube
|
||
|
||
Eigenstaendige Desktop-App für YouTube & YouTube Music (kein Browser-Fenster, keine
|
||
Erweiterung) mit:
|
||
|
||
- **Zwei Tabs** – YouTube und YouTube Music laufen parallel, Musik spielt im
|
||
Hintergrund weiter wenn du zu Videos wechselst.
|
||
- **Login/Premium** – eigenes, persistentes Profil (`%APPDATA%\Playtube`, im
|
||
Entwicklungsmodus `%APPDATA%\PlaytubeDev` – bewusst getrennt, damit sich lokale
|
||
Test-Builds nie mit einer installierten Version in die Quere kommen), einmal bei
|
||
Google anmelden reicht fuer beide Dienste.
|
||
- **Discord Rich Presence** – zeigt Titel, Kanal/Interpret, Fortschrittsbalken und
|
||
einen Link-Button in deinem Discord-Profil, sobald etwas laeuft.
|
||
- **System-Tray** – Fenster schliessen minimiert nur (Musik laeuft weiter), Rechtsklick
|
||
aufs Tray-Icon zum Beenden, Play/Pause/Skip direkt aus dem Menue.
|
||
- **Eigener Name** – erscheint als "Playtube" im Taskmanager, Fenstertitel, Alt-Tab
|
||
und (nach dem Packaging, siehe unten) im Lautstaerkemixer statt als "python".
|
||
|
||
## Schnellstart (Entwicklung)
|
||
|
||
```powershell
|
||
python -m venv .venv
|
||
.venv\Scripts\pip install -r requirements.txt
|
||
.venv\Scripts\python main.py
|
||
```
|
||
|
||
Beim ersten Start meldest du dich einmal in einem der beiden Tabs mit deinem
|
||
Google-Konto an (Symbol oben rechts auf youtube.com bzw. music.youtube.com) - der
|
||
Login bleibt danach dauerhaft gespeichert.
|
||
|
||
## Discord Rich Presence einrichten
|
||
|
||
Die Client-ID ist bereits in `config.json` eingetragen (`discord.client_id`). Falls du
|
||
sie aendern oder eine eigene Anwendung nutzen willst:
|
||
|
||
1. Auf https://discord.com/developers/applications eine neue Application anlegen.
|
||
2. Die **Application ID** in `config.json` unter `discord.client_id` eintragen.
|
||
3. Optional, fuer eigene Icons: unter *Rich Presence → Art Assets* zwei Bilder mit den
|
||
exakten Schluesseln `youtube_logo` und `music_logo` hochladen (Playtube nutzt genau
|
||
diese Keys automatisch). Ohne hochgeladene Assets funktioniert die Presence trotzdem,
|
||
nur ohne Bild.
|
||
4. Discord muss auf demselben Rechner laufen, damit die Presence angezeigt wird.
|
||
|
||
In `config.json` lassen sich zudem `update_interval_seconds` (Mindestabstand zwischen
|
||
Updates) und `show_idle_presence` (Status anzeigen, wenn gerade nichts laeuft) anpassen.
|
||
|
||
## App als eigenstaendige Playtube.exe packen
|
||
|
||
Fuer die volle Taskmanager-/Audiomixer-Markierung wird die App als eigene .exe gebaut
|
||
(ein via `python main.py` gestarteter Prozess heisst in Windows immer "python.exe" -
|
||
nur eine kompilierte .exe mit eigenem Namen und eigener Versionsinfo kann das aendern):
|
||
|
||
```powershell
|
||
.venv\Scripts\pip install pyinstaller
|
||
powershell -ExecutionPolicy Bypass -File packaging\build.ps1
|
||
```
|
||
|
||
Ergebnis liegt danach unter `dist\Playtube\Playtube.exe`. Beim ersten Start dieser
|
||
`.exe` legt Playtube automatisch eine Verknuepfung im Windows-Startmenue an (Playtube
|
||
wird ja als portables ZIP ohne Installer ausgeliefert - ohne diesen Schritt gaebe es
|
||
sonst keinen Startmenue-Eintrag).
|
||
|
||
Das Build-Skript benennt
|
||
zusaetzlich den QtWebEngine-Hilfsprozess (der den eigentlichen Ton ausgibt) zu
|
||
`PlaytubeHelper.exe` um, damit er im Taskmanager nicht als `QtWebEngineProcess`
|
||
auftaucht. Fuer eine vollstaendige Umbenennung inkl. Icon/Versionsinfo dieses
|
||
Hilfsprozesses (relevant fuer den Lautstaerkemixer) zusaetzlich
|
||
[rcedit](https://github.com/electron/rcedit/releases) als `packaging\rcedit.exe`
|
||
ablegen - das Skript nutzt es automatisch, wenn vorhanden. Ohne rcedit funktioniert
|
||
alles genauso, nur zeigt der Lautstaerkemixer fuer den Ton-Unterprozess je nach
|
||
Windows-Version eventuell weiterhin "QtWebEngineProcess" statt "Playtube" (rein
|
||
kosmetisch - Namensgebung von Chromium-Hilfsprozessen ist ein bekanntes,
|
||
Windows-versionsabhaengiges Verhalten, das selbst grosse Electron-Apps nur mit rcedit
|
||
o.ae. umgehen).
|
||
|
||
## Automatische Updates
|
||
|
||
Playtube prueft beim Start und danach alle `updates.check_interval_hours` Stunden
|
||
(Standard 6, im **Einstellungen-Tab** oder in `config.json` einstellbar) die
|
||
[GitHub Releases](https://github.com/fojadrachi/Playtube/releases) des Projekts. Im
|
||
Einstellungen-Tab gibt es zusaetzlich einen "Jetzt nach Updates suchen"-Button mit
|
||
Status-Anzeige und Fortschrittsbalken fuer den Download. Gibt es eine neuere Version,
|
||
fragt ein Dialog, ob sie installiert werden soll:
|
||
|
||
- **Gepackte `Playtube.exe`/`Playtube`**: laedt bevorzugt das kleine **Patch-Paket**
|
||
herunter (nur die ausfuehrbare Datei mit unserem Anwendungscode, ca. 2-3 MB statt
|
||
~200 MB) und ersetzt ausschliesslich diese - der riesige PySide6/QtWebEngine-
|
||
Laufzeitordner (`_internal/`) bleibt unangetastet, da er sich zwischen normalen
|
||
Patch-Releases nicht aendert. Nur wenn kein Patch-Paket verfuegbar ist (z.B. beim
|
||
allerersten Release oder nach einem Wechsel der PySide6-Version), wird automatisch
|
||
auf das volle Release-Paket zurueckgefallen und der komplette Installationsordner
|
||
ersetzt. Die App startet sich in beiden Faellen danach selbst neu.
|
||
- **Entwicklungsmodus** (`python main.py`): fuehrt `git pull` + `pip install -r
|
||
requirements.txt` aus und startet den Python-Prozess neu.
|
||
|
||
Auto-Update laesst sich im Einstellungen-Tab oder in `config.json` unter
|
||
`updates.enabled` deaktivieren.
|
||
|
||
Nach einem erkannten Update wird beim naechsten Start automatisch der QtWebEngine-
|
||
HTTP-Cache geleert (`webprofile/cache`) - alte Cache-Eintraege koennen sonst nicht mehr
|
||
zum neuen Code passen (fruehere Ursache fuer fehlende Icons). Der Login bleibt davon
|
||
unberuehrt, da Cookies/LocalStorage in einem komplett getrennten Ordner
|
||
(`webprofile/storage`) liegen.
|
||
|
||
### Patch-Dateien manuell installieren (`.play`)
|
||
|
||
Windows-Patch-Pakete tragen die eigene Dateiendung `.play` statt `.zip` (technisch
|
||
weiterhin ein ganz normales ZIP-Archiv). Playtube registriert `.play` beim ersten Start
|
||
automatisch als Windows-Dateizuordnung - eine manuell heruntergeladene
|
||
`Playtube-vX.Y.Z-win64-patch.play` (z.B. von der
|
||
[Releases-Seite](https://github.com/fojadrachi/Playtube/releases)) laesst sich also
|
||
einfach per Doppelklick installieren, ohne dass Playtube selbst etwas herunterladen
|
||
muss.
|
||
|
||
### Eine neue Version veroeffentlichen
|
||
|
||
```powershell
|
||
powershell -ExecutionPolicy Bypass -File packaging\release.ps1 -Version 1.1.0
|
||
```
|
||
|
||
Das Skript setzt die Versionsnummer, committet, erstellt Git-Tag `v1.1.0` und pusht zu
|
||
`origin` (dein Repo unter https://github.com/fojadrachi/Playtube). Der gepushte Tag
|
||
loest automatisch die GitHub-Actions-Pipeline
|
||
([.github/workflows/release.yml](.github/workflows/release.yml)) aus, die **sowohl
|
||
eine Windows- als auch eine Linux-Version baut** und beide als Assets an einem GitHub
|
||
Release veroeffentlicht - Fortschritt unter
|
||
https://github.com/fojadrachi/Playtube/actions.
|
||
|
||
Alle Nutzer mit einer laufenden Playtube-Installation (Windows oder Linux) bekommen die
|
||
neue Version danach automatisch angeboten.
|
||
|
||
## Native Linux-Version
|
||
|
||
Playtube laeuft genauso unter Linux (gleicher Code, gleiches PySide6/QtWebEngine) und
|
||
wird bei jedem Release automatisch als `Playtube-vX.Y.Z-linux-x86_64.tar.gz` unter
|
||
https://github.com/fojadrachi/Playtube/releases mitgebaut.
|
||
|
||
**Fertiges Release installieren** (richtet Startmenue-Eintrag + Icon ein):
|
||
|
||
```sh
|
||
tar -xzf Playtube-vX.Y.Z-linux-x86_64.tar.gz
|
||
cd Playtube
|
||
sh install-linux.sh
|
||
```
|
||
|
||
Danach ist Playtube ueber das Anwendungsmenue oder den Befehl `playtube` startbar.
|
||
|
||
**Aus dem Quellcode starten:**
|
||
|
||
```sh
|
||
python3 -m venv .venv
|
||
.venv/bin/pip install -r requirements.txt
|
||
.venv/bin/python main.py
|
||
```
|
||
|
||
QtWebEngine benoetigt unter Linux ein paar System-Bibliotheken (auf Debian/Ubuntu):
|
||
`sudo apt install libxkbcommon0 libegl1 libnss3 libxcomposite1 libxdamage1 libxrandr2 libgbm1 libasound2t64 libatk-bridge2.0-0 libcups2` (siehe auch die vollstaendige Liste in
|
||
[.github/workflows/release.yml](.github/workflows/release.yml)).
|
||
|
||
## Hinweise
|
||
|
||
- **"Dieser Browser ist unter Umstaenden nicht sicher" beim Google-Login:** Playtube
|
||
setzt einen echten Chrome-User-Agent inkl. passender `Sec-CH-UA`-Header, damit Google
|
||
das eingebettete Chromium (QtWebEngine) nicht als unsicheres WebView erkennt. Sollte
|
||
die Meldung dennoch erscheinen: alle Playtube-Fenster/-Prozesse schliessen und neu
|
||
starten (die Header greifen erst ab dem naechsten Prozessstart), notfalls einmal den
|
||
Profilordner `%APPDATA%\Playtube\webprofile` (bzw. `PlaytubeDev` im
|
||
Entwicklungsmodus) loeschen und neu anmelden.
|
||
- 4K/Premium-Videoqualitaet kann eingeschraenkt sein, da die Open-Source-Variante von
|
||
QtWebEngine kein Widevine-DRM mitbringt (Standard-Qualitaeten funktionieren normal).
|
||
- Icon/Branding-Bilder liegen unter `assets/` und wurden mit `tools/generate_icon.py`
|
||
erzeugt (Pillow) - bei Bedarf einfach eigenes `icon.ico`/`icon.png` dort ersetzen.
|