byse-video-manager/README.md
Administrator fa0aa4736b fix: Umlaute in README und Konsolenausgaben (ä/ö/ü statt ae/oe/ue)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 06:03:30 +01:00

2.9 KiB

Byse.sx Video Manager

CLI-Tool zum Aufräumen deines Byse.sx-Accounts. Scannt alle Videos, findet solche mit 0 Views die älter als 3 Monate sind, und löscht sie auf Wunsch in Batches.

Features

  • Scannt alle Videos deines Accounts (paginiert, ~70K+ Videos kein Problem)
  • Filtert nach Alter und Views
  • Interaktives Menü: Liste durchblättern, CSV exportieren, löschen
  • Batch-Löschung mit Fortschrittsanzeige
  • Sicherheitsabfrage vor dem Löschen (Tippe LOESCHEN)
  • Optionaler Alters-Filter (z.B. nur Videos älter als 6 Monate)

Voraussetzungen

Einrichtung

git clone https://git.24-music.de/Administrator/byse-video-manager.git
cd byse-video-manager
npm install

Das Tool nutzt die interne Byse.sx-API, die einen Session-Cookie benötigt:

  1. Öffne byse.sx im Browser und logge dich ein
  2. Öffne die DevTools (F12)
  3. Gehe zu Application > Cookies > https://byse.sx
  4. Kopiere den Wert des sid-Cookies
  5. Erstelle eine .env Datei im Projektordner:
cp .env.example .env
  1. Trage deinen sid-Wert ein:
BYSE_SID=dein_session_cookie_hier

Hinweis: Der Session-Cookie läuft nach einiger Zeit ab. Wenn du eine Fehlermeldung bekommst, hole dir einfach einen neuen aus dem Browser.

Benutzung

node index.js

Menü-Optionen

[1] Liste anzeigen     - Blättert durch die Kandidaten (je 50)
[2] CSV exportieren    - Speichert alle Kandidaten als byse-candidates.csv
[3] ALLE löschen       - Löscht alle Kandidaten (Sicherheitsabfrage)
[4] Nach Alter filtern - Nur Videos älter als X Monate löschen
[5] Beenden

Beispiel-Ausgabe

════════════════════════════════════════════════
  ERGEBNIS
════════════════════════════════════════════════
  Gesamt Videos:        69.595
  Kandidaten (0 Views,
    älter als 3 Mon.):  17.525
  Speicher freigeben:   13.67 TB
  Ältestes Video:       2025-05-02
  Neuester Kandidat:    2025-12-04
════════════════════════════════════════════════

API-Details

Das Tool nutzt die interne Byse.sx Dashboard-API (nicht die öffentliche API):

Endpoint Methode Zweck
/api/my_files_overview GET Account-Übersicht
/api/my_files_files GET Video-Liste (Cursor-Pagination)
/api/del_file POST Videos löschen

Authentifizierung erfolgt über den sid Session-Cookie.

Sicherheit

  • Die .env Datei mit deinem Session-Cookie wird nicht ins Git committed (.gitignore)
  • Vor dem Löschen muss LOESCHEN getippt werden
  • Löschung ist unwiderruflich