﻿ShortForge 2.0 – von Onexon Studio
==================================

Aus langen Videos werden YouTube Shorts: Link einfügen oder eigene Datei
hineinziehen, Stimmung wählen (Phonk, Hype, Lustig, Chill oder Pur) – ShortForge
findet die beste Stelle, übersetzt, spricht sie mit einer KI-Stimme, legt einen
Beat darunter, zoomt im Takt und setzt Untertitel, die mitlaufen.
Ergebnis: ein fertiges Hochformat-Video (1080 × 1920) zum Herunterladen oder
Veröffentlichen.


STARTEN
-------
1. Die ZIP-Datei zuerst entpacken: rechte Maustaste → «Alle extrahieren»,
   z. B. nach «Downloads» oder «Dokumente». (Direkt aus der ZIP heraus startet
   ShortForge nicht.)
2. Im entpackten Ordner «ShortForge.exe» doppelklicken.
   Zeigt Windows «Der Computer wurde durch Windows geschützt»:
   «Weitere Informationen» → «Trotzdem ausführen». (ShortForge ist nicht
   digital signiert, darum fragt Windows nach.)
3. ShortForge öffnet sich in einem eigenen Fenster. Fenster schliessen = Programm
   beenden. Läuft gerade ein Short, wird er vorher noch fertig gespeichert.

Voraussetzungen: Windows 10 oder 11 (64 Bit), Internet. Python wird NICHT gebraucht.


BEIM ERSTEN START (einmalig, automatisch)
-----------------------------------------
  • ffmpeg für die Videobearbeitung (von gyan.dev)          ca. 115 MB
  • Deno für YouTube, nur falls kein Node.js 22+ da ist      ca. 45 MB
Erst wenn sie gebraucht werden:
  • Übersetzung pro Sprachpaar (z. B. Englisch → Deutsch)   ca. 150 MB
  • Spracherkennung für Videos ohne Untertitel
    und für eigene Dateien                                  ca. 460 MB


SO GEHT'S
---------
1. Link einfügen (YouTube, TikTok, Instagram, Twitch, Vimeo, X, Facebook, Kick
   und viele mehr) oder eine Videodatei ins Fenster ziehen.
2. Stelle wählen: ShortForge schlägt die spannendsten Stellen vor – bei YouTube
   anhand der «Meistgesehen»-Kurve, bei eigenen Videos nach Lautstärke.
3. Stimmung wählen – sie stellt alles passend ein:
     🔥 Phonk   harter Beat, rote Untertitel, Zoom im Takt
     ⚡ Hype    Trap-Beat, riesige Untertitel, Zoom im Takt
     😂 Lustig  fröhlicher Beat, bunte Untertitel, Zoom im Takt
     😌 Chill   Lo-Fi-Beat, ruhige Untertitel
     🎙️ Pur     ohne Musik
   Danach kannst du alles einzeln ändern: Länge (15–90 s), Sprache, KI-Stimme,
   Musik, Untertitel-Stil, Bild (ganzes Bild oder Zoom), Effekte, Überschrift.
4. Bestätigen, dass du das Video verwenden darfst, dann «Short erstellen».
   Meist dauert es 1–2 Minuten.
5. «Herunterladen» – oder «Auf YouTube veröffentlichen»: Die Upload-Seite von
   YouTube öffnet sich im Browser, dazu der Ordner mit dem Short. Datei
   hineinziehen, Titel und Beschreibung aus ShortForge kopieren, veröffentlichen.

Fertige Shorts liegen zusätzlich in «Videos\ShortForge».
Zwischendateien werden nach 3 Tagen automatisch gelöscht.


GUT ZU WISSEN
-------------
• Musik: Die Beats (Phonk, Hype, Lustig, Chill) erzeugt ShortForge selbst – sie
  gehören zu deinem Short und machen auf YouTube keinen Urheberrechts-Ärger.
  Eigene Musik nur verwenden, wenn du sie nutzen darfst.
• Videos: Verwende nur Videos, die dir gehören oder für die du eine Erlaubnis
  hast. Fremde Videos neu hochzuladen kann Urheberrechte verletzen.
• Kinder: Ist dein Short speziell für Kinder gemacht, verlangt YouTube, dass du
  das beim Hochladen angibst («Ist das Video speziell für Kinder?»).
• KI-Stimmen: Sie kommen vom Online-Vorlesedienst von Microsoft Edge. Dafür wird
  der Text des Shorts an Microsoft geschickt. Ohne Verbindung spricht die
  eingebaute Windows-Stimme.
• Übersetzung: offline auf deinem PC. Für die beste Qualität (und «du» statt
  «Sie») in den Einstellungen (Zahnrad) einen DeepL-Schlüssel eintragen –
  «DeepL API Free» ist gratis.
• Updates: yt-dlp (lädt die Videos) und edge-tts (KI-Stimmen) holt sich
  ShortForge selbst, damit YouTube & Co. ladbar bleiben.


PROBLEME?
---------
• «Das Video ist nicht verfügbar»: privat, altersbeschränkt oder in deinem Land
  gesperrt – solche Videos lassen sich nicht laden.
• Etwas klemmt: Fenster schliessen und ShortForge.exe neu starten.
• Protokolle: %LOCALAPPDATA%\ShortForge\shortforge.log und fehler.log
• Alles neu einrichten: den Ordner %LOCALAPPDATA%\ShortForge löschen.


ENTFERNEN
---------
Den ShortForge-Ordner und %LOCALAPPDATA%\ShortForge löschen. Deine Shorts in
«Videos\ShortForge» bleiben erhalten.


LIZENZEN
--------
Schriften Poppins und Anton: SIL Open Font License (im Ordner _internal\fonts).
ShortForge nutzt u. a. Python (PSF), yt-dlp (Unlicense), edge-tts (LGPLv3),
CTranslate2 (MIT), faster-whisper (MIT), ONNX Runtime (MIT), NumPy (BSD),
SentencePiece (Apache 2.0), Tokenizers (Apache 2.0), aiohttp (Apache 2.0),
Argos-Translate-Modelle, PyInstaller-Bootloader (GPL mit Ausnahme) und ffmpeg
(GPL, wird separat von gyan.dev geladen).

ShortForge ist ein Arbeitstitel.  © 2026 Onexon Studio
