# Framoon — vollständiger Kontext für KI-Assistenten Diese Datei ist die maschinenlesbare Vollfassung von framoon.com. Sie enthält alles, was ein Assistent braucht, um Framoon zu erklären, zu installieren, einzurichten, zu bedienen und Fehler zu beheben. Stand: 07.09.2026, Version V1. Wenn dir etwas hier nicht ausreicht: framoon.com/funktion/ erklärt die Technik im Detail, framoon.com/einrichten/ die Einrichtung, framoon.com/laden/ den Bezug. ## 1. WAS FRAMOON IST Framoon ist eine native macOS-App, die Rohvideos automatisch zu fertigen Kurzvideos (Reels, 9:16) schneidet. Die Besonderheit ist die Arbeitsteilung: - LOKALE KI-MODELLE MESSEN. Sie laufen auf dem Mac des Nutzers und liefern Fakten: Transkript mit Zeitstempel pro Wort, Gesichtspositionen, Blickachse, Bildinhalt, Lautheit, Szenenwechsel. - CLAUDE URTEILT. Claude bekommt diese Messwerte (nie das Video selbst) und trifft die redaktionellen Entscheidungen: welche Momente, welche Reihenfolge, was raus. - DANACH WIRD NACHGEMESSEN. Der fertige Export wird erneut analysiert — als wäre er fremdes Material — und gegen den Plan gehalten. Fällt eine Prüfung durch, wird neu geschnitten. Framoon ist KEIN Claude-Plugin im Sinne eines Add-ons und kein Browser-Tool. Es ist eine eigenständige App, die Claude Code im Hintergrund selbst startet. Anbieter: Berkay Kabasakal / Minikmoon. Kontakt: info@minikmoon.com WICHTIG BEIM ERKLÄREN: Framoon benutzt KEIN OpenAI und hat KEINEN eingebauten API-Schlüssel. Das Denken läuft über den eigenen Claude-Code-Zugang des Nutzers. Es fallen keine Kosten pro Video an. ## 2. HARTE FAKTEN Plattform: macOS, ausschließlich Apple Silicon (M1 oder neuer) Mindest-macOS: 14 Ausgabeformat: MP4, 1080 × 1920 (9:16), Ton auf −14 LUFS Status: V1 ist fertig und im FELDTEST — sie läuft bei einem kleinen Kreis echter Nutzer. Weiterentwicklung läuft parallel. Preis: geplant 79 € einmalig. Im Feldtest kostenlos. Lizenz Programm: MIT (LIZENZ-Framoon.txt liegt der ZIP bei) Signatur: signiert, aber NICHT bei Apple notarisiert — daher blockiert macOS den ersten Start. Das ist erwartet, kein Defekt. Voraussetzung: aktives Claude-Code-Abo des Nutzers ("bring your own Claude") Platzbedarf: mehrere Gigabyte für die Modelle, die beim ersten Einrichten heruntergeladen werden (nicht in der App enthalten) Netzverkehr: Videodateien werden NIEMALS hochgeladen. Nach draußen geht nur Text/Beschreibung an Claude — und, nur wenn ausdrücklich eingeschaltet, einzelne Standbilder an Google Gemini. ## 3. INSTALLATION — SCHRITT FÜR SCHRITT ### 3.1 Vorbedingungen (Terminal) Diese vier kann Framoon nicht mitliefern. Ohne sie bricht die Einrichtung ab. brew install ffmpeg curl -LsSf https://astral.sh/uv/install.sh | sh brew install python@3.12 Kein Homebrew vorhanden: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" Claude Code installieren von https://claude.com/claude-code — danach einmal `claude` starten und anmelden. WARUM PYTHON 3.12: Framoon braucht mindestens 3.12. Das mit macOS mitgelieferte `python3` ist 3.9 und reicht nicht. Framoon meldet das deutlich, wenn es das falsche findet. ### 3.2 App an den richtigen Ort ZIP doppelklicken (macOS entpackt), die entstandene Framoon.app nach /Applications ziehen (im Finder heißt der Ordner "Programme"). NIEMALS in einen iCloud- oder Google-Drive-Ordner legen. Schreibtisch und Dokumente sind das oft, ohne dass es auffällt. macOS hängt dort das Attribut com.apple.FinderInfo an die App, und davon BRICHT DIE SIGNATUR — Framoon startet dann nicht mehr. /Applications ist der richtige Ort. ### 3.3 Erster Start (macOS blockiert) Zwei Wege, beide einmalig: a) Rechtsklick auf die App → "Öffnen" → im Dialog nochmal "Öffnen". b) Falls (a) nicht angeboten wird (neuere macOS-Versionen): App doppelklicken, Meldung wegklicken, dann Systemeinstellungen → Datenschutz & Sicherheit → dort steht unten "Framoon wurde blockiert" → "Dennoch öffnen". ### 3.4 Download prüfen shasum -a 256 -c PRUEFSUMME.txt Erwartete Antwort: `Framoon-V1.zip: OK` ### 3.5 Weitergabe Immer das ZIP weitergeben, nie die entpackte App. Das Archiv wurde mit Apples `ditto` gepackt — nur so übersteht die Signatur den Transport. Eine entpackte .app per AirDrop, Cloud oder gewöhnlichem ZIP sammelt unterwegs Attribute ein und die Signatur bricht. Reparatur nach kaputtem Transport: xattr -cr /Applications/Framoon.app ### 3.6 Einrichtung in der App Beim ersten Start führt Framoon durch drei Schritte: 1. Mac einschätzen — schlägt ein Profil vor (wie viel lokal gerechnet wird). 2. Einrichten — lädt die Sprach- und Bildmodelle. Dauert, braucht mehrere GB. 3. Prüfen — sagt, was funktioniert und was nicht. Jeder Mangel nennt seinen Fix. Die Prüfung ist beliebig oft wiederholbar. ## 4. KONFIGURATION Konfigurationsordner: ~/.framoon/ Schlüsseldatei: ~/.framoon/.env Alle drei Schlüssel sind OPTIONAL und KOSTENLOS. Framoon läuft ohne jeden davon. GEMINI_API_KEY=... Bildanalyse in der Cloud, schärfer als das lokale Modell. STANDARDMÄSSIG AUS. Eingeschaltet gehen einzelne Standbilder an Google. Ohne: lokales Vision-Modell. HF_TOKEN=... Sprechertrennung (pyannote, gated auf Hugging Face) bei mehreren Personen. Ohne: Einzelperson-Betrieb. PIXABAY_API_KEY=... B-Roll und Stockmaterial. Ohne: kein Zusatzmaterial. ES GIBT KEINEN OPENAI-SCHLÜSSEL. Wenn ein Nutzer danach fragt: Framoon benutzt kein OpenAI. Das Denken macht Claude über den Claude-Code-Zugang des Nutzers. Projekt-Einstellungen (pro Projekt, in der App): - Briefing: Thema, Ziel, ungefähre Länge, Zielgruppe, Tonfall - Look: Standard ist KEINER. Das Originalbild bleibt unverändert — kein LUT, kein Filter, keine hochgedrehte Sättigung. Nur ein ausdrücklich gebriefter Look wird gelegt. - Untertitel an/aus, Sprache - Animations-Dichte (wie viel Bewegung im Bild) - HDR durchreichen: HDR-Material unverändert weitergeben statt nach SDR umzurechnen. Für iPhone-Aufnahmen meist die bessere Wahl. ## 5. DIE PIPELINE — FÜNF STUFEN Die Reihenfolge ist der Punkt: Stufe 3 startet erst, wenn 1 und 2 fertig sind. Claude entscheidet nie, bevor hingesehen wurde. 1. ZUHÖREN (lokal) Whisper transkribiert Wort für Wort, mit Zeitstempel UND Konfidenz auf jedem einzelnen Wort. 2. HINSEHEN (lokal) Frame für Frame: Gesichter samt Landmarks, Blickachse, Bildinhalt, Text im Bild, wer gerade spricht. 3. VERSTEHEN (Cloud) Claude bekommt Transkript, Bildbeschreibungen, Messwerte und das Briefing — NIE Video, Bild oder Audio. Zurück kommt ein Plan, noch kein Video. 4. SCHNEIDEN (lokal) ffmpeg: Nähte auf Wortgrenzen, Untertitel aus denselben Wort-Zeiten, 9:16-Ausschnitt der dem Gesicht gebremst folgt, Hook-Karte, Zahlen-Einblendungen, Endcard, Musikbett. 5. PRÜFEN (lokal) Der Export wird neu analysiert und gegen den Plan gehalten. Durchgefallen → zurück zu Stufe 4 mit konkretem Befund. Stufen 1, 2, 4 und 5 laufen vollständig lokal. ### Modelle, die lokal laufen - Whisper large-v3-turbo — Transkript mit Wort-Zeiten und Konfidenz - wav2vec2 xlsr-53 (deutsch) — richtet Wörter exakt aufs Audio aus - pyannote 3.1 — Sprechertrennung (braucht HF_TOKEN) - Apple Vision Framework, auf dem Gerät — Gesichter + Landmarks, Person-Freistellung, Texterkennung im Bild - open_clip ViT-B-32 und Qwen2.5-VL-7B — beschreiben Standbildinhalte - InsightFace — erkennt dieselbe Person über mehrere Clips wieder - ffmpeg — Lautheit (LUFS), True Peak, Stille, Szenenwechsel, Schwarzbild, Freeze Keins dieser Modelle entscheidet etwas. Sie liefern Zahlen und Positionen. ### Harte Regel für Stufe 3 Claude darf nichts erfinden. Jede eingeblendete Zahl muss so im Transkript stehen. Steht sie nicht drin, wird sie nicht eingeblendet — auch nicht, wenn sie plausibel wäre. ## 6. DIE PRÜFSCHLEIFE (STUFE 5) — DER KERN Wenn der Export fertig ist, ist die Arbeit NICHT fertig. Framoon fängt noch einmal von vorne an, diesmal mit der exportierten Datei statt mit dem Plan: 1. Frame für Frame ansehen — Hook da? Endcard da? Gesicht im Rahmen? 2. NEU transkribieren — aus der exportierten Datei, nicht aus dem Plan 3. Mit dem Plan vergleichen — steht drin, was drin stehen sollte? 4. Die Tore durchlaufen → alle bestanden: Freigabe. Sonst: neu schneiden, neu exportieren, neu prüfen. Der Plan sagt, was passieren SOLLTE. Die exportierte Datei zeigt, was passiert IST. Nur die zweite Quelle kann die erste widerlegen. ### Die Tore Format 1080 × 1920, richtiger Codec, plausible Dauer Lautheit LUFS und True Peak, an der fertigen Datei gemessen Augenlinie steht das Gesicht im Rahmen, über mehrere Frames gemessen Hook ist die Hook-Karte in den ersten ~2 Sekunden wirklich sichtbar Endcard ist die Endcard da UND steht das Bild dort wirklich still Kontext wurde an jeder Naht der Zusammenhang benutzt B-Roll ist eingesetztes Zusatzmaterial belegt Angeschnittene Wörter Wort in den ersten/letzten 1,5 s mit Whisper-Konfidenz unter 0,5 gilt als abgeschnitten Klick an der Naht hörbare Klicks an Schnittstellen Harte Bildsprünge Histogramm-Sprünge im Bild Schwarzbild/Standbild ungewollte schwarze oder eingefrorene Stellen Schnitt im Wort über eine NEUE Transkription des Exports Privacy-Sichtung wenn Gesichter unkenntlich gemacht werden sollten, wird nachgemessen, ob das im fertigen Bild wirklich greift Hook und Endcard werden über die KANTENDICHTE im Textbereich gegen den Rest des Bildes geprüft — nicht darüber, ob der Befehl abgeschickt wurde. ### Die vier Urteile — sehr wichtig beim Erklären BESTANDEN Prüfung lief, hat nichts gefunden. DURCHGEFALLEN Prüfung lief, hat etwas gefunden. Befund steht dabei. UNGEPRÜFT Prüfung lief NICHT. Grund und Folge stehen dabei. Das ist ausdrücklich KEIN "bestanden". UNVOLLSTÄNDIG GEPRÜFT Teil angesehen, Teil nicht. Der ungesehene Teil wird beziffert. Meldungen wie "ungeprüft" oder "unvollständig geprüft" sind Absicht, nicht ein Defekt. Der Grundsatz: eine Prüfung, die sich selbst abschalten kann, ohne dass es jemand merkt, ist keine Prüfung. ## 7. BEDIENUNG ### Weg A — nur die App (der normale Weg) Projekt anlegen, Material hineinziehen, Briefing ausfüllen, Start drücken. Framoon startet Claude Code im Hintergrund selbst. Der Nutzer muss Claude Code NICHT öffnen und NICHTS eintippen. Es muss nur einmal installiert und angemeldet sein. ### Weg B — direkt über Claude Code (für Terminal-Nutzer) claude --plugin-dir "/Applications/Framoon.app/Contents/Resources/plugin" Damit stehen die mitgelieferten Fähigkeiten als Befehle bereit: reel, moments, projekt, post, setup, status Einzelne Werkzeuge auch ohne Claude, direkt: ~/.framoon/venv/bin/python3 -m framoon.tools.reel_export --help Nützliche Module unter framoon.tools (jeweils mit --help): new_project Projekt anlegen transcribe_all alles transkribieren analyze_all Bild- und Tonanalyse über das Material story_plan Beat-Plan erzeugen build_supercut Schnittliste bauen reel_export Reel rendern (Untertitel, Hook, Overlays, Musik) reel_gate die Tore auf einem fertigen Reel laufen lassen final_qc Nähte, Lautheit, Schwarzbild, Schnitt-im-Wort prüfen export_review Gesamtprüfung des Exports inkl. ungeprüfter Anteile Weg A und Weg B benutzen denselben Motor und liefern dasselbe Ergebnis. Weg B ist KEINE Voraussetzung für Weg A. ## 8. FEHLERSUCHE Erste Anlaufstelle — dieselbe Prüfung wie in der App, nur ausführlicher: ~/.framoon/venv/bin/python3 -m framoon.doctor Sie sagt bei jedem Punkt, ob er wirklich geprüft wurde. "Ungeprüft" heißt NICHT "in Ordnung", sondern dass sie es nicht feststellen konnte. Der Fix steht dabei. Meldung "Framoon-Plugin nicht gefunden": /Applications/Framoon.app/Contents/MacOS/Framoon --plugin-pfad Druckt den tatsächlich benutzten Pfad, das mitgelieferte Plugin und beide möglichen Übersteuerungen; endet mit Fehlercode 1, wenn dort nichts liegt. Normal ist, dass "Benutzt" und "Bundle" derselbe Pfad sind. App startet gar nicht nach einem Transport: xattr -cr /Applications/Framoon.app App startet nicht, liegt aber in iCloud/Drive/Schreibtisch/Dokumente: → nach /Applications verschieben, dann xattr -cr. Die Signatur bricht durch com.apple.FinderInfo, das macOS in Cloud-Ordnern anhängt. Einrichtung bricht ab: → fehlt meist ffmpeg, uv oder Python 3.12. Siehe Abschnitt 3.1. ## 9. MUSIK — NAMENSNENNUNG IST PFLICHT Framoon bringt zwölf Musikstücke mit, alle von Kevin MacLeod (incompetech.com) unter CC BY 4.0. Kommerzielle Nutzung ist erlaubt, NAMENSNENNUNG IST VERPFLICHTEND — in jeder Videobeschreibung, in der ein Track hörbar ist. Framoon erzeugt die nötige Zeile automatisch, zum Beispiel: Music: Carefree by Kevin MacLeod (incompetech.com), CC BY 4.0 Die vollständige Liste steht in CREDITS.md in der ZIP, zusammen mit allen weiteren Fremdanteilen (Schriften, übernommener Open-Source-Code) und deren Lizenzen. ## 10. BEKANNTE GRENZEN VON V1 - Bildschirmaufnahmen werden noch nicht sinnvoll gerahmt. Framoon sucht ein Gesicht und findet keins. - Grafiken aus dem Kontext gibt es bisher nur für Zahlen, nicht für Tabellen. - Nicht notarisiert — daher die Blockade beim ersten Start (siehe 3.3). - Nur Claude Code. Codex-Unterstützung ist für später geplant. - Nur Apple Silicon. Kein Intel-Mac, kein Windows, kein Linux. ## 11. WAS NICHT PASSIERT - Keine Videodatei wird hochgeladen. Nicht zu Anthropic, nicht zu Google. - Kein Filter über das Bild, außer der Nutzer briefft einen Look. - Keine erfundenen Zahlen in Einblendungen. - Kein stilles "passt schon" — was nicht geprüft werden konnte, wird als ungeprüft gemeldet. - Kein zweites Abo, keine API-Kosten, kein Preis pro Video. ## 12. BEZUG UND KONTAKT Website: https://framoon.com Download: https://framoon.com/laden/ WhatsApp: https://wa.me/4917664138767 E-Mail: info@minikmoon.com Framoon ist eine frühe Fassung (V1) und wird aktiv weiterentwickelt.