Files
FuerDieCuts/README.md
T
ferdi2goandClaude Opus 5.5 d7102d04a4 Import-Oberfläche mit Zeitraum, Clipauswahl und Upload bauen
Der Browser liest den entpackten Exportordner selbst, schlägt Montag bis
Freitag der Vorwoche vor, zeigt Videos pro Tag und warnt bei Lücken und
fehlenden Dateien. Nur die gewählten Videos werden hochgeladen; ein
abgebrochener Upload lässt sich in der Projektansicht fortsetzen.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-29 10:04:40 +00:00

77 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.