96 lines
2.9 KiB
Markdown
96 lines
2.9 KiB
Markdown
# 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
|
|
|
|
- [Node.js](https://nodejs.org/) v18 oder neuer
|
|
|
|
## Einrichtung
|
|
|
|
```bash
|
|
git clone https://git.24-music.de/Administrator/byse-video-manager.git
|
|
cd byse-video-manager
|
|
npm install
|
|
```
|
|
|
|
### Session-Cookie holen
|
|
|
|
Das Tool nutzt die interne Byse.sx-API, die einen Session-Cookie benötigt:
|
|
|
|
1. Öffne [byse.sx](https://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:
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
6. 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
|
|
|
|
```bash
|
|
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**
|