# FuerDieCuts

Schneidet aus einem WhatsApp-Chatexport automatisch ein YouTube-Video.

Der Export (ZIP mit Medien) wird hochgeladen, die Videos werden anhand der
Zeitstempel im Chat chronologisch sortiert. Über eine Maske wählt man, was
automatisch passieren soll:

- Intro und Outro einfügen (eigene Dateien)
- Clips chronologisch aneinanderreihen
- Clips über 10 Sekunden auf genau 10 Sekunden beschleunigen
- Ton der Clips stummschalten (Intro und Outro ausgenommen)
- Backing Track unter den Clip-Teil legen (wird wiederholt und passend gekürzt)
- Voice-over pro Clip aufnehmen oder hochladen
- Lautstärke jeder Tonspur von 0 bis 100

Ausgabe ist ein MP4 in 1920×1080 mit 30 fps. Hochkant-Clips werden mittig mit
unscharfem Hintergrund eingesetzt. Zugang ist über eine PIN geschützt.

> Stand: Anmeldung, Import des Exports und Upload der Videos laufen. Der Schnitt folgt.

## Voraussetzungen

- Node.js 20
- ffmpeg und ffprobe im `PATH` (`sudo apt install ffmpeg`)

## Installation und Start

```bash
npm install
cp .env.example .env   # APP_PIN eintragen
npm run dev
```

`npm run dev` startet den Express-Server samt Vite im Entwicklungsmodus auf
einem Port (`PORT`, Vorgabe 3000) und liest dabei die lokale `.env`. In Produktion:

```bash
npm run build
NODE_ENV=production APP_PIN=… npm start
```

## Umgebungsvariablen

| Name | Bedeutung |
|---|---|
| `APP_PIN` | PIN für die Anmeldung, Pflicht |
| `SESSION_SECRET` | optional; signiert die Sitzungs-Cookies, sonst wird eines erzeugt |
| `PORT` | Port des Servers, Vorgabe 3000 |
| `VCH_DATA_DIR` | Ablage für Projekte und Uploads, Vorgabe `./data` |

## Ablauf

1. WhatsApp-Chat mit „Medien anhängen“ exportieren und entpacken.
2. In der App „Neues Video“, den Exportordner wählen. Der Browser liest den
   Chat selbst; vorgewählt ist Montag bis Freitag der Vorwoche.
3. Videos prüfen (Duplikate sind abgewählt) und hochladen. Nur die gewählten
   Videos werden übertragen, in Stücken von 8 MB; ein Abbruch lässt sich durch
   erneutes Wählen des Ordners fortsetzen.

## Befehle

- `npm test` – Tests (Node-Testrunner)
- `npm run lint` – ESLint
- `npm run build` – Frontend bauen

## Aufbau

- `server/` – Express-Server: Anmeldung, Projekte, Upload in Stücken, ffprobe
- `src/` – React-Oberfläche (Vite)
- `src/lib/whatsapp.js` – liest den Chatexport und ordnet die Videos
- `src/lib/upload.js` – Upload in Stücken mit Wiederaufnahme
- `test/` – Tests
- `Dockerfile` – Produktionsimage mit ffmpeg; Deploy über VCH (`.vch/deploy.yaml`)

Aufgebaut auf Node.js, Express, React, Vite und ffmpeg.