byse-video-manager/README.md
Administrator c6cca124a6 docs: add README with setup instructions and .env.example
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 06:00:07 +01:00

2.9 KiB

Byse.sx Video Manager

CLI-Tool zum Aufraumen deines Byse.sx-Accounts. Scannt alle Videos, findet solche mit 0 Views die aelter als 3 Monate sind, und loescht sie auf Wunsch in Batches.

Features

  • Scannt alle Videos deines Accounts (paginiert, ~70K+ Videos kein Problem)
  • Filtert nach Alter und Views
  • Interaktives Menue: Liste durchblaettern, CSV exportieren, loeschen
  • Batch-Loeschung mit Fortschrittsanzeige
  • Sicherheitsabfrage vor dem Loeschen (Tippe LOESCHEN)
  • Optionaler Alters-Filter (z.B. nur Videos aelter 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 benoetigt:

  1. Oeffne byse.sx im Browser und logge dich ein
  2. Oeffne 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 laeuft nach einiger Zeit ab. Wenn du eine Fehlermeldung bekommst, hole dir einfach einen neuen aus dem Browser.

Benutzung

node index.js

Menue-Optionen

[1] Liste anzeigen     - Blaettert durch die Kandidaten (je 50)
[2] CSV exportieren    - Speichert alle Kandidaten als byse-candidates.csv
[3] ALLE loeschen      - Loescht alle Kandidaten (Sicherheitsabfrage)
[4] Nach Alter filtern - Nur Videos aelter als X Monate loeschen
[5] Beenden

Beispiel-Ausgabe

════════════════════════════════════════════════
  ERGEBNIS
════════════════════════════════════════════════
  Gesamt Videos:        69.595
  Kandidaten (0 Views,
    aelter als 3 Mon.): 17.525
  Speicher freigeben:   13.67 TB
  Aeltestes Video:      2025-05-02
  Neuestes Kandidat:    2025-12-04
════════════════════════════════════════════════

API-Details

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

Endpoint Methode Zweck
/api/my_files_overview GET Account-Uebersicht
/api/my_files_files GET Video-Liste (Cursor-Pagination)
/api/del_file POST Videos loeschen

Authentifizierung erfolgt ueber den sid Session-Cookie.

Sicherheit

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