Hilfe & häufige Fragen
Help & frequently asked questions
56 Fragen — von „läuft das auf meinem Mac“ bis „warum sagt Framoon ungeprüft“. Jede bekannte Fehlerquelle steht hier mit ihrer Ursache und ihrer Lösung. Findest du deine Frage nicht: schreib mir.
56 questions — from “will this run on my Mac” to “why does Framoon say unchecked”. Every known failure source is here with its cause and its fix. Can't find your question? Message me.
Bevor du anfängst
Before you start
Läuft Framoon auf meinem Mac?
Du brauchst einen Mac mit Apple Silicon (M1, M2, M3, M4 oder neuer) und macOS 14 oder neuer. Nachsehen: Apfel-Menü oben links → „Über diesen Mac“.
Steht dort Intel, läuft Framoon nicht — und wird es auch nicht. Die lokalen KI-Modelle brauchen die Neural Engine von Apple Silicon.
Will Framoon run on my Mac?
You need a Mac with Apple Silicon (M1, M2, M3, M4 or newer) and macOS 14 or newer. To check: Apple menu, top left → “About This Mac”.
If it says Intel, Framoon won't run — and won't in future either. The local AI models need Apple Silicon's Neural Engine.
Brauche ich wirklich ein Claude-Code-Abo?
Ja. Framoon bringt keine eigene KI für die Entscheidungen mit — es benutzt deinen Zugang. Ohne Abo laufen zwar die lokalen Analysen, aber niemand trifft die redaktionellen Entscheidungen, und es entsteht kein Schnitt.
Das ist Absicht: dadurch zahlst du nichts pro Video und es steckt kein fremder API-Schlüssel im Programm.
Do I really need a Claude Code subscription?
Yes. Framoon brings no AI of its own for the decisions — it uses your access. Without a subscription the local analyses still run, but nobody makes the editorial calls, so no edit happens.
That's deliberate: it means you pay nothing per video and no third-party API key is baked into the app.
Kostet mich jedes Video etwas?
Nein. Es gibt keine Abrechnung pro Video, keine API-Kosten und kein zweites Abo. Framoon läuft über deinen bestehenden Claude-Code-Zugang.
Does every video cost me something?
No. There's no per-video billing, no API costs and no second subscription. Framoon runs on your existing Claude Code access.
Was kostet Framoon?
Geplant sind 79 € einmalig. Im laufenden Feldtest ist Framoon kostenlos — ich gebe V1 gerade an einen kleinen Kreis, damit ich das Feedback auch wirklich verarbeiten kann.
What does Framoon cost?
The plan is €79, one-off. During the ongoing field test Framoon is free — I'm handing V1 to a small circle so I can genuinely act on the feedback.
Ist Framoon ein Claude-Plugin?
Nein. Framoon ist eine eigenständige Mac-App mit eigener Oberfläche: Projektliste, Rohmaterial, Briefing, Ergebnis, Rückmeldung. Sie benutzt Claude Code im Hintergrund, ist aber kein Add-on darin.
Wer will, kann denselben Motor auch direkt über Claude Code fahren — das ist der zweite Weg, nicht der normale.
Is Framoon a Claude plugin?
No. Framoon is a standalone Mac app with its own interface: project list, footage, brief, result, feedback. It uses Claude Code in the background but isn't an add-on inside it.
If you want, you can drive the same engine through Claude Code directly — that's the second route, not the normal one.
Muss ich Claude Code selbst öffnen und bedienen?
Nein. Framoon startet Claude Code selbst im Hintergrund. Du musst es einmal installieren und dich anmelden — danach nie wieder anfassen.
Do I have to open and operate Claude Code myself?
No. Framoon starts Claude Code in the background for you. You install it and sign in once — after that you never touch it again.
Gibt es Framoon für Windows oder Linux?
Nein, und das ist auch nicht geplant. Framoon nutzt Apples Vision-Framework auf dem Gerät und die Neural Engine — beides gibt es nur auf dem Mac.
Is there a Windows or Linux version?
No, and none is planned. Framoon uses Apple's on-device Vision framework and the Neural Engine — both Mac-only.
Wie viel Speicherplatz brauche ich?
Die App selbst ist klein (rund 76 MB als ZIP). Was Platz braucht, sind die Sprach- und Bildmodelle, die beim ersten Einrichten geladen werden — rechne mit mehreren Gigabyte. Dazu kommt dein eigenes Rohmaterial und die Zwischenergebnisse pro Projekt.
How much disk space do I need?
The app itself is small (about 76 MB as a ZIP). What takes space are the speech and vision models pulled during first setup — budget several gigabytes. On top of that comes your own footage and the per-project intermediate files.
Installation und erster Start
Installation and first launch
macOS sagt, die App sei blockiert oder beschädigt
Das ist erwartet und kein Defekt. Framoon ist signiert, aber noch nicht bei Apple notariert — ein bezahlter Vorgang, der aussteht.
Zwei Wege, beide einmalig:
- Rechtsklick auf die App → „Öffnen“, im Dialog nochmal „Öffnen“.
- Wird das nicht angeboten (neuere macOS-Versionen): App normal doppelklicken, Meldung wegklicken, dann Systemeinstellungen → Datenschutz & Sicherheit — dort steht unten „Framoon wurde blockiert“ → „Dennoch öffnen“.
Danach startet sie für immer normal.
macOS says the app is blocked or damaged
This is expected, not a defect. Framoon is signed but not yet notarised with Apple — a paid step still pending.
Two routes, both one-time:
- Right-click the app → “Open”, then “Open” again in the dialog.
- If that isn't offered (newer macOS): double-click normally, dismiss the message, then System Settings → Privacy & Security — at the bottom it says “Framoon was blocked” → “Open Anyway”.
After that it launches normally forever.
Die App startet gar nicht mehr, auch nicht mit Rechtsklick
Meist hat der Transport die Signatur zerstört — AirDrop, ein gewöhnliches ZIP, eine Cloud unterwegs. Das repariert es:
xattr -cr /Applications/Framoon.appHilft das nicht: die App liegt vermutlich in einem Cloud-Ordner. Siehe die nächste Frage.
The app won't start at all, not even with right-click
Usually the transport broke the signature — AirDrop, an ordinary ZIP, a cloud folder on the way. This repairs it:
xattr -cr /Applications/Framoon.appIf that doesn't help, the app is probably sitting in a cloud folder. See the next question.
Darf ich die App auf den Schreibtisch legen?
Besser nicht. Schreibtisch und Dokumente liegen bei vielen Macs unbemerkt in iCloud. macOS hängt dort ein unsichtbares Attribut namens com.apple.FinderInfo an das Programm — und davon bricht die Signatur. Framoon startet dann nicht mehr.
Dasselbe gilt für Google Drive und Dropbox. Der richtige Ort ist der Ordner Programme.
Can I keep the app on my Desktop?
Better not. On many Macs the Desktop and Documents silently live in iCloud. There macOS attaches an invisible attribute called com.apple.FinderInfo to the app — and that breaks the signature. Framoon then won't start.
The same goes for Google Drive and Dropbox. The right place is the Applications folder.
„command not found: brew“
Homebrew ist noch nicht installiert. Das holt es nach:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Es fragt nach deinem Mac-Passwort. Beim Tippen bewegt sich nichts auf dem Bildschirm — das ist normal, tipp zu Ende und drück Enter.
“command not found: brew”
Homebrew isn't installed yet. This installs it:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"It asks for your Mac password. Nothing moves on screen while you type — that's normal; type it out and hit Enter.
Wie prüfe ich, ob mein Download heil ist?
Im Terminal, im Ordner mit der ZIP:
shasum -a 256 -c PRUEFSUMME.txtErwartete Antwort: Framoon-V1.zip: OK. Kommt etwas anderes, lade die Datei neu.
How do I check my download is intact?
In Terminal, in the folder holding the ZIP:
shasum -a 256 -c PRUEFSUMME.txtExpected answer: Framoon-V1.zip: OK. Anything else means download it again.
Darf ich die App an jemanden weitergeben?
Im Feldtest: sag mir bitte kurz Bescheid, damit ich weiß, wer sie testet. Technisch wichtig ist: immer das ZIP weitergeben, nie die entpackte App.
Das Archiv wurde mit Apples ditto gepackt — nur so übersteht die Signatur den Transport. Schiebt man die entpackte App durch AirDrop oder ein gewöhnliches ZIP, hängt macOS unterwegs Attribute an und die Signatur bricht.
Can I pass the app on to someone?
During the field test: please give me a heads-up so I know who's testing. Technically what matters: always pass on the ZIP, never the unpacked app.
The archive was packed with Apple's ditto — the only way the signature survives transport. Push the unpacked app through AirDrop or an ordinary ZIP and macOS attaches attributes on the way, breaking the signature.
Einrichtung und Modelle
Setup and models
Warum dauert das erste Einrichten so lange?
Weil die KI-Modelle geladen werden — mehrere Gigabyte. Das passiert genau einmal. Wie lange es dauert, hängt an deiner Leitung, nicht am Mac.
Danach läuft alles offline auf deinem Rechner.
Why does the first setup take so long?
Because the AI models are being downloaded — several gigabytes. It happens exactly once. How long depends on your connection, not your Mac.
After that everything runs offline on your machine.
Warum stecken die Modelle nicht gleich in der App?
Zwei Gründe. Erstens die Größe: die App wäre mehrere Gigabyte groß statt 76 MB. Zweitens die Lizenzen — Framoon liefert grundsätzlich keine Modellgewichte mit, sondern lädt sie von der Originalquelle auf deinen Mac. Welche das sind, steht in CREDITS.md.
Why aren't the models bundled into the app?
Two reasons. Size: the app would be several gigabytes instead of 76 MB. And licensing — Framoon never bundles model weights; it fetches them from their original source onto your Mac. Which ones is listed in CREDITS.md.
„Framoon-Plugin nicht gefunden“
Das hier druckt, welches Plugin tatsächlich benutzt wird:
/Applications/Framoon.app/Contents/MacOS/Framoon --plugin-pfadNormal ist, dass „Benutzt“ und „Bundle“ derselbe Pfad sind — dann nimmt Framoon sein eigenes, mitgeliefertes Plugin. Der Befehl endet mit Fehlercode 1, wenn dort nichts liegt; dann ist die App unvollständig entpackt und du lädst die ZIP am besten neu.
“Framoon plugin not found”
This prints which plugin is actually in use:
/Applications/Framoon.app/Contents/MacOS/Framoon --plugin-pfadIt's normal for “used” and “bundle” to be the same path — that means Framoon uses its own bundled plugin. The command exits with code 1 if nothing is there; in that case the app was unpacked incompletely and you should re-download the ZIP.
Was macht doctor, und wann brauche ich ihn?
doctor ist dieselbe Prüfung wie in der App, nur ausführlicher — die erste Anlaufstelle, wenn irgendetwas klemmt:
~/.framoon/venv/bin/python3 -m framoon.doctorSie sagt bei jedem Punkt, ob er wirklich geprüft wurde, und nennt zu jedem Mangel den Fix. „Ungeprüft“ heißt dabei nicht „in Ordnung“, sondern dass sie es nicht feststellen konnte.
What does doctor do, and when do I need it?
doctor is the same check as in the app, just more detailed — the first stop when anything is off:
~/.framoon/venv/bin/python3 -m framoon.doctorIt states for every point whether it was actually checked, and names the fix for every issue. “Unchecked” does not mean “fine” — it means it couldn't determine it.
Brauche ich die drei API-Schlüssel?
Nein. Framoon läuft ohne jeden davon, alle drei sind optional und kostenlos. Sie kommen in ~/.framoon/.env:
- GEMINI_API_KEY — schärfere Bildanalyse in der Cloud. Standardmäßig aus. Ohne ihn übernimmt das lokale Modell.
- HF_TOKEN — Sprechertrennung bei mehreren Personen. Ohne ihn: Einzelperson-Betrieb.
- PIXABAY_API_KEY — B-Roll und Stockmaterial. Ohne ihn: kein automatisches Zusatzmaterial.
Einen OpenAI-Schlüssel gibt es nicht — Framoon benutzt kein OpenAI.
Do I need the three API keys?
No. Framoon runs without any of them; all three are optional and free. They go into ~/.framoon/.env:
- GEMINI_API_KEY — sharper cloud image analysis. Off by default. Without it the local model handles it.
- HF_TOKEN — speaker separation for multiple people. Without it: single-speaker operation.
- PIXABAY_API_KEY — B-roll and stock footage. Without it: no automatic extra material.
There is no OpenAI key — Framoon doesn't use OpenAI.
Die Sprechertrennung erkennt niemanden
Dafür braucht Framoon das Modell pyannote, und das ist auf Hugging Face zugangsbeschränkt. Du brauchst einen kostenlosen HF_TOKEN in ~/.framoon/.env und musst die Modellbedingungen auf Hugging Face einmal bestätigen.
Ohne das läuft Framoon im Einzelperson-Betrieb — funktioniert, ordnet aber bei mehreren Sprechern nichts zu.
Speaker separation doesn't recognise anyone
For this Framoon needs the pyannote model, which is gated on Hugging Face. You need a free HF_TOKEN in ~/.framoon/.env and have to accept the model terms on Hugging Face once.
Without it Framoon runs in single-speaker mode — works fine, but attributes nothing when several people speak.
Beim Arbeiten
While working
Wie lange dauert ein Reel?
Das hängt an drei Dingen: wie viel Rohmaterial du reingibst, aus wie vielen Clips, und wie stark dein Mac ist. Eine allgemeingültige Zahl wäre geraten.
Was du sicher weißt: der erste Lauf in einem Projekt ist der langsamste, weil alles einmal transkribiert und Bild für Bild analysiert werden muss. Danach liegen diese Ergebnisse vor, und Änderungen am Schnitt gehen deutlich schneller.
How long does a reel take?
It depends on three things: how much footage you feed in, across how many clips, and how strong your Mac is. A universal number would be a guess.
What you can count on: the first run in a project is the slowest, because everything has to be transcribed and analysed frame by frame once. After that those results exist, and changes to the edit go noticeably faster.
Das Ergebnis gefällt mir nicht — was jetzt?
Sag es Framoon. Das Ergebnis ist kein Endpunkt, sondern ein Vorschlag: du kannst direkt am Reel Rückmeldung geben — „der Anfang zieht nicht“, „das ist zu lang“, „die Stelle mit dem Preis muss rein“.
Der Plan wird angepasst und ab dem Schnitt läuft die Kette neu, inklusive Prüfung. Die Analyse muss dabei nicht wiederholt werden, deshalb geht das zügig.
I don't like the result — now what?
Tell Framoon. The result isn't an endpoint but a proposal: you can give feedback right on the reel — “the opening doesn't land”, “this is too long”, “the bit about the price has to stay”.
The plan gets adjusted and the chain re-runs from the edit, verification included. The analysis doesn't have to be repeated, so it's quick.
Eine wichtige Stelle wurde rausgeschnitten
Sag konkret, welche — am besten mit dem Wortlaut, nicht mit der Zeitangabe. Framoon findet die Stelle im Transkript wieder und baut sie ein.
Wenn dir vorher schon klar ist, dass etwas unbedingt drin sein muss, schreib es ins Briefing. Dann fließt es in die Planung ein, statt nachträglich repariert zu werden.
An important moment got cut out
Say which one — ideally by quoting the words, not the timecode. Framoon finds the spot in the transcript and puts it back.
If you already know beforehand that something must be included, put it in the brief. Then it feeds into the planning instead of being patched in afterwards.
Das Reel ist zu kurz oder zu lang
Die Länge steuerst du im Briefing. Sie ist ein Wunsch, kein Gesetz — wenn der Inhalt es nicht hergibt, wird Framoon eher kürzer als gestreckt, weil gestreckte Reels langweilen.
Willst du bewusst mehr Information drin haben, sag das ausdrücklich: „lieber länger, ich gebe viele Infos, schneide nur die leeren Stellen raus“.
The reel is too short or too long
You control length in the brief. It's a wish, not a law — if the content doesn't support it, Framoon errs shorter rather than padded, because padded reels are boring.
If you deliberately want more information in there, say so: “longer is fine, I'm giving a lot of info, just cut the empty parts”.
In den Untertiteln stehen Tippfehler
Die Untertitel kommen aus der Spracherkennung, und die verhört sich — vor allem bei Eigennamen, Produktnamen und Fachbegriffen. „Musselinedecke“ oder ein Markenname sind typische Kandidaten.
Nenn die richtige Schreibweise im Briefing oder in der Rückmeldung, dann wird sie korrigiert. Die Zeiten bleiben dabei erhalten, weil nur der Text ersetzt wird.
There are typos in the captions
Captions come from speech recognition, and it mishears — especially proper nouns, product names and jargon. Brand names are typical candidates.
Give the correct spelling in the brief or in your feedback and it gets corrected. The timings stay intact, because only the text is replaced.
Kann ich das Ergebnis danach noch selbst bearbeiten?
Ja. Am Ende steht eine ganz gewöhnliche MP4-Datei, 1080 × 1920. Die kannst du in jedes Schnittprogramm ziehen — CapCut, Premiere, Final Cut, was du magst.
Can I edit the result myself afterwards?
Yes. What comes out is an ordinary MP4 file, 1080 × 1920. Drop it into any editor — CapCut, Premiere, Final Cut, whatever you like.
Der Chat in der App meldet blockierte Berechtigungen
Framoon startet Claude Code in einem Automatik-Modus, in dem die Werkzeuge, die es braucht, bereits freigegeben sind. Du solltest im normalen Betrieb keine Berechtigungsfragen sehen.
Wenn doch etwas als blockiert gemeldet wird, läuft mit hoher Wahrscheinlichkeit eine ältere Fassung. Hol dir die aktuelle ZIP von der Download-Seite und prüfe die Prüfsumme.
The in-app chat reports blocked permissions
Framoon starts Claude Code in an automation mode where the tools it needs are already approved. In normal operation you should see no permission prompts.
If something is reported as blocked anyway, you're most likely running an older build. Get the current ZIP from the download page and verify the checksum.
Der Lauf bricht mittendrin ab
Die häufigste Ursache ist banal: der Projektordner oder der Export-Ordner wurde währenddessen verschoben, umbenannt oder geleert. Framoon schreibt dann in etwas, das es nicht mehr gibt.
Lass die Projektordner in Ruhe, solange ein Lauf läuft. Danach:
~/.framoon/venv/bin/python3 -m framoon.doctorBleibt es dabei, schick mir bitte die Meldung — genau dafür ist der Feldtest da.
The run aborts midway
The most common cause is mundane: the project folder or the export folder was moved, renamed or emptied while it was running. Framoon then writes into something that no longer exists.
Leave the project folders alone while a run is going. Afterwards:
~/.framoon/venv/bin/python3 -m framoon.doctorIf it persists, please send me the message — that's exactly what the field test is for.
Bild, Farbe und Ausschnitt
Picture, colour and framing
Die Farben sehen anders aus als im Original
Sollten sie nicht. Der Standard ist ausdrücklich: das Original bleibt das Original — kein LUT, kein Filter, keine hochgedrehte Sättigung.
Wenn dein Bild trotzdem anders aussieht, hast du meist HDR-Material aufgenommen (iPhone macht das standardmäßig). Siehe HDR-Durchreichen.
The colours look different from the original
They shouldn't. The default is explicit: the original stays the original — no LUT, no filter, no cranked saturation.
If your picture still looks different, you most likely shot HDR footage (iPhone does this by default). See HDR passthrough.
Alles wirkt zu rot oder orange
Das ist das klassische Zeichen für eine doppelte HDR-Umrechnung: das Material wurde einmal von HDR nach SDR gerechnet, und das Anzeigegerät rechnet nochmal. Ergebnis sind übersättigte, ins Orange gezogene Hauttöne.
Die Abhilfe ist HDR durchreichen in den Projekt-Einstellungen: dann bleibt das Material unangetastet und nur das Endgerät wandelt — einmal, richtig.
Everything looks too red or orange
That's the classic sign of a double HDR conversion: the footage was converted from HDR to SDR once, and the display converts again. The result is oversaturated skin tones pulled towards orange.
The fix is HDR passthrough in the project settings: the footage stays untouched and only the end device converts — once, correctly.
Legt Framoon einen Filter über mein Bild?
Nur wenn du einen willst. Standardmäßig: nein. Ein Look wird ausschließlich gelegt, wenn du ihn ausdrücklich briefst.
Ein Filter ist dabei genau das — ein Filter, keine Farbkorrektur, die dein Bild „verbessern“ will.
Does Framoon put a filter over my picture?
Only if you want one. By default: no. A look is applied solely when you explicitly brief one.
And a filter is exactly that — a filter, not a grade trying to “improve” your picture.
Was ist „HDR durchreichen“, und wann brauche ich das?
iPhones nehmen standardmäßig in HDR auf. Beim Schnitt gibt es zwei Möglichkeiten: nach SDR umrechnen, oder das HDR unverändert weitergeben.
Durchreichen ist meist die bessere Wahl, besonders für Instagram und TikTok: die Plattformen und die Telefone der Zuschauer können HDR selbst, und jede Umrechnung ist ein Verlust — im schlimmsten Fall der Orange-Stich.
Die Einstellung findest du pro Projekt in den Projekt-Einstellungen.
What is “HDR passthrough” and when do I need it?
iPhones record in HDR by default. When editing there are two options: convert to SDR, or pass the HDR through untouched.
Passthrough is usually the better choice, especially for Instagram and TikTok: the platforms and your viewers' phones handle HDR themselves, and every conversion is a loss — worst case the orange cast.
You'll find the setting per project in the project settings.
Der 9:16-Ausschnitt schneidet mich an
Der Ausschnitt folgt deinem Gesicht, aber gebremst — die Kamera wandert, sie springt nicht. Dabei gilt eine harte Regel: die Augenlinie muss im Rahmen bleiben, und das wird nach dem Export an mehreren Frames nachgemessen.
Wenn du trotzdem angeschnitten wirst, hilft meistens das Rohmaterial: steh nicht ganz am Bildrand und lass oben etwas Luft über dem Kopf. Aus einem Bild, in dem du am Rand klebst, kann kein 9:16-Ausschnitt dich mittig zeigen.
The 9:16 crop cuts me off
The crop follows your face, but damped — the camera drifts, it doesn't jump. One hard rule applies: the eye line must stay in frame, and that's re-measured across several frames after export.
If you still get cropped, the footage is usually the lever: don't stand right at the edge of frame and leave some headroom. No 9:16 crop can centre you in a shot where you're glued to the edge.
Bildschirmaufnahmen werden komisch gerahmt
Bekannte Grenze von V1, ehrlich benannt: Framoon sucht ein Gesicht, um den Ausschnitt zu führen — und findet in einer Bildschirmaufnahme keins. Das Ergebnis ist entsprechend willkürlich.
Sauberes Framing für Bildschirmaufnahmen steht auf der Liste für die nächste Fassung. Bis dahin: Bildschirmaufnahmen besser separat behandeln.
Screen recordings get framed oddly
A known V1 limitation, named honestly: Framoon looks for a face to guide the crop — and finds none in a screen recording. The result is correspondingly arbitrary.
Proper framing for screen recordings is on the list for the next build. Until then: handle screen recordings separately.
Warum immer 9:16? Geht auch 16:9?
V1 macht 9:16, also 1080 × 1920 — das Format für Reels, TikTok und Shorts. Darauf ist die ganze Kette ausgelegt, bis hin zu den Prüfungen.
Andere Seitenverhältnisse sind für später vorgesehen, aber nicht Teil von V1.
Why always 9:16? Can it do 16:9?
V1 produces 9:16, i.e. 1080 × 1920 — the format for Reels, TikTok and Shorts. The whole chain is built around it, right down to the checks.
Other aspect ratios are planned for later but aren't part of V1.
In einem älteren Beispiel sehe ich schwarze Zwischenbilder und heftige Zooms
Die stammen aus früheren Fassungen. Beides ist behoben: die schwarzen Zwischenbilder sind vollständig ausgebaut — nicht abschaltbar gemacht, sondern entfernt — und die Zoomfahrten sind jetzt an das gebunden, was das Originalbild hergibt, statt frei zu skalieren.
Das YouTube-Beispiel auf der Startseite ist bewusst als ältere Fassung gekennzeichnet.
In an older example I see black frames and wild zooms
Those come from earlier builds. Both are fixed: the black frames were removed entirely — not made optional, removed — and zoom moves are now bounded by what the original frame supports instead of scaling freely.
The YouTube example on the home page is deliberately labelled as an older build.
Ton und Musik
Audio and music
Der Ton klingt dumpf oder komisch
Schick mir bitte das Reel — genau dafür ist der Feldtest da. Zwei Ursachen, die in früheren Fassungen vorkamen und behoben sind: eine falsche Abtastrate beim Export und eine zu harte Dynamikbearbeitung. Beides ist raus; der Ton wird nur noch auf einen einheitlichen Pegel gebracht, ohne die Dynamik plattzudrücken.
Läuft eine ältere Fassung, hol dir die aktuelle ZIP.
The audio sounds muffled or odd
Please send me the reel — that's exactly what the field test is for. Two causes that occurred in earlier builds and are fixed: a wrong sample rate on export, and overly hard dynamics processing. Both are gone; audio is now only brought to a consistent level without flattening the dynamics.
If you're on an older build, get the current ZIP.
Warum wird der Ton auf −14 LUFS gebracht?
Weil Instagram, TikTok und YouTube damit rechnen. Lieferst du lauter, drehen die Plattformen selbst herunter — und das klingt schlechter, als wenn man gleich richtig liefert.
Der Pegel wird an der fertigen Datei gemessen, nicht am Plan.
Why is audio brought to −14 LUFS?
Because Instagram, TikTok and YouTube expect it. Deliver louder and the platforms turn it down themselves — which sounds worse than delivering it right in the first place.
The level is measured on the finished file, not on the plan.
Muss ich die Musik wirklich nennen?
Ja, das ist Pflicht. Die zwölf mitgelieferten Stücke sind von Kevin MacLeod 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 mit, zum Beispiel:
Music: Carefree by Kevin MacLeod (incompetech.com), CC BY 4.0Du musst sie nur mit in die Beschreibung kopieren.
Do I really have to credit the music?
Yes, it's mandatory. The twelve bundled tracks are by Kevin MacLeod under CC BY 4.0. Commercial use is allowed, attribution is required — in every video description where a track is audible.
Framoon generates the required line for you, for example:
Music: Carefree by Kevin MacLeod (incompetech.com), CC BY 4.0You just need to paste it into the description.
Kann ich eigene Musik verwenden?
Ja — dann liegt die Rechteklärung allerdings bei dir. Die mitgelieferten zwölf Stücke haben den Vorteil, dass ihre Lizenz geklärt ist und Framoon die Namensnennung automatisch erzeugt.
Can I use my own music?
Yes — but then clearing the rights is on you. The advantage of the twelve bundled tracks is that their licensing is settled and Framoon generates the attribution automatically.
Im fertigen Reel ist gar kein Ton
Prüf zuerst, ob das Rohmaterial Ton hat — bei Bildschirmaufnahmen fehlt er oft, ohne dass man es merkt. Danach hilft:
~/.framoon/venv/bin/python3 -m framoon.doctorFehlt ffmpeg, kann Framoon Ton weder lesen noch schreiben. Das ist die häufigste Ursache.
The finished reel has no audio at all
First check whether the source footage has audio — screen recordings often lack it without you noticing. Then:
~/.framoon/venv/bin/python3 -m framoon.doctorIf ffmpeg is missing, Framoon can neither read nor write audio. That's the most common cause.
Meldungen verstehen
Understanding the messages
Framoon meldet „ungeprüft“ — ist das ein Fehler?
Nein, das ist Absicht — und einer der wichtigsten Punkte an Framoon.
Es gibt vier Urteile: bestanden (Prüfung lief, nichts gefunden), durchgefallen (Prüfung lief, etwas gefunden), ungeprüft (Prüfung lief nicht) und unvollständig geprüft (ein Teil angesehen, ein Teil nicht).
„Ungeprüft“ ist ausdrücklich kein „bestanden“. Eine Prüfung, die sich selbst abschalten kann, ohne dass es jemand merkt, ist keine Prüfung. Deshalb sagt Framoon lieber, dass es etwas nicht weiß, als still ein gutes Ergebnis zu behaupten. Der Grund steht immer dabei.
Framoon says “unchecked” — is that an error?
No, it's deliberate — and one of the most important things about Framoon.
There are four verdicts: passed (check ran, found nothing), failed (check ran, found something), unchecked (the check did not run) and partially checked (part looked at, part not).
“Unchecked” is explicitly not a “pass”. A check that can switch itself off without anyone noticing isn't a check. So Framoon would rather say it doesn't know than quietly claim a good result. The reason is always stated.
„Mehrere Qualitätsstufen übersprungen“
Genau das, was dasteht: diese Prüfungen konnten nicht laufen und werden deshalb nicht als bestanden gemeldet. Zu jeder übersprungenen Stufe stehen zwei Dinge im Bericht: warum sie nicht lief und was daraus folgt — also welche Aussage jetzt fehlt.
Lies diese Begründung, bevor du das Reel benutzt. Typische Gründe sind fehlende Eingangsdaten aus einem früheren Schritt oder ein Werkzeug, das nicht verfügbar war.
“Several quality stages skipped”
Exactly what it says: those checks couldn't run and are therefore not reported as passed. For every skipped stage the report states two things: why it didn't run and what follows from that — which assurance is now missing.
Read that reasoning before you use the reel. Typical causes are missing inputs from an earlier step, or a tool that wasn't available.
Ein Tor ist durchgefallen — und jetzt?
Im Normalfall musst du nichts tun: ein durchgefallenes Tor schickt den Lauf zurück in den Schnitt, mit dem konkreten Befund im Gepäck. Danach wird neu exportiert und neu geprüft.
Bleibt ein Tor hartnäckig, liegt es meist am Rohmaterial und nicht am Schnitt — etwa die Augenlinie, wenn du im Original ganz am Bildrand stehst.
A gate failed — now what?
Normally you do nothing: a failed gate sends the run back to the edit, carrying the concrete finding. Then it re-exports and re-checks.
If a gate keeps failing, it's usually the footage rather than the edit — for instance the eye line when you're at the very edge of the original frame.
Framoon meldet angeschnittene Wörter
Am Anfang oder Ende eines Reels wurde ein Wort erwischt, das nur halb drin ist. Erkannt wird das daran, dass die Spracherkennung dort ungewöhnlich unsicher ist — ein halbes Wort ist schwer zu verstehen, für die Maschine wie für deine Zuschauer.
Framoon verschiebt die Naht in der Regel selbst. Kommt die Meldung trotzdem durch, hör dir Anfang und Ende einmal an.
Framoon reports clipped words
At the start or end of a reel a word got caught only half-in. It's detected by the speech recognition being unusually unsure there — half a word is hard to understand, for the machine as for your viewers.
Framoon usually moves the seam itself. If the message still comes through, listen to the start and end once.
Was ist die „Privacy-Sichtung“?
Wenn Gesichter im Video unkenntlich gemacht werden sollten, prüft Framoon am fertigen Bild nach, ob die Unkenntlichmachung auch wirklich greift — Fenster für Fenster, nicht nur an einer Stichprobe.
Der Grund: dass der Befehl abgeschickt wurde, heißt nicht, dass im Bild etwas passiert ist. Nur die Messung am Ergebnis beweist das.
What is the “privacy sweep”?
If faces were meant to be obscured, Framoon re-checks the finished picture to confirm the masking actually took — window by window, not just on a sample.
The reason: issuing the command doesn't mean anything happened in the picture. Only measuring the result proves that.
Datenschutz
Privacy
Wird mein Video irgendwohin hochgeladen?
Nein. Keine Videodatei verlässt deinen Mac — nicht zu Anthropic, nicht zu Google, nirgendwohin. Transkribieren, Bildanalyse, Schnitt und Prüfung laufen vollständig auf deinem Rechner.
Is my video uploaded anywhere?
No. No video file leaves your Mac — not to Anthropic, not to Google, nowhere. Transcription, image analysis, editing and verification all run on your machine.
Was verlässt meinen Mac denn dann?
Genau eine Sache im Normalbetrieb: Text. Claude bekommt das Transkript, die in Worte gefassten Bildbeschreibungen, die Messwerte und dein Briefing — und schickt einen Plan zurück. Kein Video, kein Bild, keine Audiodatei.
Schaltest du zusätzlich die Cloud-Bildanalyse ein, gehen einzelne Standbilder an Google. Das ist standardmäßig aus, und Framoon sagt es ausdrücklich, bevor es passiert.
So what does leave my Mac?
Exactly one thing in normal operation: text. Claude receives the transcript, the image descriptions put into words, the measurements and your brief — and sends back a plan. No video, no image, no audio file.
If you additionally enable cloud image analysis, individual still frames go to Google. That's off by default, and Framoon says so explicitly before it happens.
Was macht der Gemini-Schlüssel genau?
Er schaltet die Bildanalyse in der Cloud frei, die schärfer ist als das lokale Modell. Der Preis dafür: einzelne Standbilder aus deinem Video gehen an Google.
Deshalb ist er standardmäßig aus, und Framoon weist ausdrücklich darauf hin, bevor das erste Bild rausgeht. Ohne den Schlüssel übernimmt das lokale Vision-Modell und dein Material bleibt vollständig auf dem Mac.
What exactly does the Gemini key do?
It unlocks cloud image analysis, which is sharper than the local model. The price: individual still frames from your video go to Google.
That's why it's off by default, and Framoon warns explicitly before the first frame goes out. Without the key the local vision model handles it and your material stays entirely on the Mac.
Wo liegen meine Dateien?
Auf deinem Mac, in deinen eigenen Projektordnern. Die Konfiguration liegt unter ~/.framoon/. Es gibt keine Kontoverwaltung, keine Cloud-Bibliothek und keinen Server, auf dem etwas von dir liegt.
Where are my files stored?
On your Mac, in your own project folders. The configuration lives under ~/.framoon/. There's no account system, no cloud library and no server holding anything of yours.
Rechtliches und Kontakt
Legal and contact
Darf ich die Videos kommerziell nutzen?
Ja. Deine Videos gehören dir. Die einzige Auflage betrifft die mitgelieferte Musik: wenn ein Track hörbar ist, muss der Urheber genannt werden — die Zeile erzeugt Framoon automatisch.
Can I use the videos commercially?
Yes. Your videos are yours. The only condition concerns the bundled music: if a track is audible, the composer must be credited — Framoon generates the line for you.
Welche Lizenz hat Framoon?
Der Programmcode steht unter MIT; die Lizenzdatei liegt der ZIP bei. Alle Fremdanteile — Schriften, übernommener Open-Source-Code, Musik, Modelle — stehen mit ihrer jeweiligen Lizenz in CREDITS.md.
What licence is Framoon under?
The program code is MIT; the licence file ships with the ZIP. All third-party parts — fonts, adapted open-source code, music, models — are listed with their respective licences in CREDITS.md.
Wie melde ich einen Fehler?
Am liebsten auf WhatsApp oder per Mail an info@minikmoon.com.
Was mir am meisten hilft: was du gemacht hast, was du erwartet hast, was passiert ist — und wenn möglich die Ausgabe von:
~/.framoon/venv/bin/python3 -m framoon.doctorGenau dafür ist der Feldtest da. Es gibt keine dumme Meldung.
How do I report a bug?
Ideally on WhatsApp or by email to info@minikmoon.com.
What helps me most: what you did, what you expected, what happened — and if possible the output of:
~/.framoon/venv/bin/python3 -m framoon.doctorThat's exactly what the field test is for. There's no such thing as a silly report.
Kann mir eine KI bei Framoon helfen?
Ja, dafür gibt es eine eigene Seite. Unter framoon.com/ki/ liegt der vollständige Kontext in einer Textdatei — Installation, Konfiguration, Befehle, Fehlersuche.
Gib deinem Assistenten einfach diese Adresse: https://framoon.com/llms.txt
Can an AI help me with Framoon?
Yes, there's a dedicated page for that. At framoon.com/ki/ the complete context sits in one text file — installation, configuration, commands, troubleshooting.
Just hand your assistant this address: https://framoon.com/llms.txt
Nicht dabei?
Not covered?
Dann ist es eine gute Frage. Schreib mir — im Feldtest ist jede Rückmeldung willkommen, auch die unsortierte.
Then it's a good question. Message me — during the field test every piece of feedback is welcome, unsorted ones included.