Luxel-Dokumentation

Verwende Luxel vom ersten Start bis zum fertigen Export.

Luxel ist ein Aufnahmeprogramm für die Mac-Menüleiste und unterstützt Bildschirm- und Bereichsaufnahmen, Clips aus dem Rückblickpuffer, reine Audioaufnahmen, schwebende Kameravorschauen, lokale Transkripte, Befehlszeilenautomatisierung, Schnellexporte und Exporte über den Editor.

In drei Schritten loslegen

Starte Luxel und suche das Symbol in der Menüleiste.
Erteile nur die Berechtigungen, die für die bevorstehende Aufnahme erforderlich sind.
Wähle ein Ziel aus, nimm auf und öffne das Ergebnis anschließend im Editor oder Finder.

Über die App, den Puffer oder Skripte aufnehmen

Nutze die Menüleiste für interaktive Aufnahmen, globale Kurzbefehle für wiederkehrende Aktionen, den Rückblickpuffer für bereits vergangene Momente und den Befehl luxel für skriptgesteuerte Aufnahmen.

Einrichtung

Installation und erster Start

Luxel installieren

Installiere und starte Luxel.
Bewahre die App an einem festen Ort auf, bevor du Berechtigungen erteilst.
Öffne Luxel im Finder oder Launchpad.
Suche das Luxel-Statussymbol in der macOS-Menüleiste.

Luxel benötigt macOS 26.0 oder neuer. Da Luxel über die Menüleiste ausgeführt wird, ist das Menüleistensymbol der wichtigste Ausgangspunkt für Aufnahmen und Einstellungen.

Erste Aufnahme

Öffne Luxel über die Menüleiste.
Wähle unter „Ziel“ ein Ziel aus oder zeichne mit „Bereich“ einen eigenen Ausschnitt.
Aktiviere Systemaudio, Mikrofon oder Kamera nur, wenn die Aufnahme sie benötigt.
Klicke auf „Quelle aufnehmen“, „Bereich aufnehmen“ oder „Audio aufnehmen“.
Beende die Aufnahme über die Statussteuerung in der Menüleiste, die aktive Aufnahmesteuerung oder den Kurzbefehle.

Datenschutz

Berechtigungen

Luxel fragt Berechtigungen erst an, wenn eine Funktion sie benötigt. Fehlt eine erforderliche Berechtigung, erscheinen entsprechende Hinweise im Menü.

Bildschirm- & Systemaudioaufnahme

Erforderlich für die Aufnahme eines Displays, Fensters, Bereichs oder Systemaudios. macOS kann diese Einstellung unter „Systemeinstellungen“ > „Datenschutz & Sicherheit“ als „Bildschirm- & Systemaudioaufnahme“ bezeichnen.

Beende Luxel nach der Freigabe und öffne es erneut.

Mikrofon

Erforderlich, wenn „Mikrofon aufnehmen“ oder der Mikrofonschalter in der Bereichsauswahl aktiviert ist, wenn du eine reine Audioaufnahme startest oder solange die optionalen Spracherkennungshinweise aktiviert sind.

Du kannst „Systemstandard“ oder ein bestimmtes Eingabegerät wählen.

Mitteilungen

Nur erforderlich, wenn Spracherkennungshinweise aktiviert sind. Luxel fragt per Mitteilung, ob du nach einem Erkennungssignal eine Audioaufnahme starten möchtest.

Eine Mitteilung startet niemals selbstständig eine Aufnahme.

Kamera

Erforderlich, wenn die Kameravorschau aktiviert ist. Luxel zeigt mit der ausgewählten Kamera eine schwebende Vorschau für Aufnahmen an.

Die Kamerasteuerung erscheint, nachdem du ein Kameragerät ausgewählt hast.

Spracherkennung

Erforderlich, wenn lokale Transkripte im Editor oder über die Befehlszeile erstellt werden. Luxel verwendet die Spracherkennung auf dem Gerät.

Luxel fragt diese Berechtigung erst beim Start einer Transkription an.

Hinweis zu Berechtigungen

Beende Luxel nach einer Änderung der Berechtigung „Bildschirm- & Systemaudioaufnahme“ und öffne es erneut. Fragt macOS weiterhin nach, vergewissere dich, dass du jedes Mal dieselbe Luxel-Kopie öffnest.

Modell

Grundkonzepte

Die Menüleiste im Mittelpunkt

Luxel befindet sich in der Menüleiste. Das Panel enthält Zielauswahl, Aufnahmetasten, Audioschalter, Berechtigungsstatus, letzte Dateien, Rückblicksteuerung und den Zugang zu den Einstellungen.

Ziele

Ein Ziel kann ein Display, ein App-Fenster oder ein ausgewählter Bereich sein. Befehle für aktives Fenster und Vollbild bestimmen ihr Ziel beim Start der Aufnahme.

Aufnahmeordner

Neue Aufnahmen werden standardmäßig in ~/Movies/Luxelgespeichert. In den Ausgabeeinstellungen kannst du einen anderen Ordner wählen.

Editor

Normale Videoaufnahmen werden nach der Aufnahme im Editor geöffnet. Reine Audioaufnahmen lassen sich dort wiedergeben, transkribieren und als Audio exportieren. Schnellexporte können direkt in eine Datei oder Folgeaktion münden.

Schnellexporte

Exportvorgaben können eine Aufnahme ohne manuelles Öffnen jeder Exportoption in GIF, MP4, HEVC MP4, ProRes MOV oder APNG umwandeln.

Wiedergabepuffer

Der Rückblickpuffer ist ein optionaler, fortlaufender Aufnahmemodus. Er hält die letzte Bildschirmhistorie bereit, sodass du die gewählte vergangene Dauer als normale MP4-Aufnahme exportieren kannst.

Lokale Transkripte

Luxel transkribiert Audio auf deinem Mac. Die lokale Sprechererkennung kann Gespräche unterscheiden, bekannte Sprecher zuordnen und Transkriptabschnitte beschriften. Transkripte bleiben im Editor oder werden über die CLI als Text oder JSON geschrieben.

Letzte Dateien

Das Menü zeigt die neueste Aufnahme sowie ein Untermenü „Zuletzt“, über das Clips im Editor geöffnet oder im Finder angezeigt werden können.

Anleitung

Aufnahmeanleitung

Bildschirm, Fenster oder Bereich aufnehmen

Öffne Luxel über die Menüleiste.
Wähle „Ziel“ und anschließend ein Display oder Fenster.
Aktiviere bei Bedarf Systemaudio oder Mikrofon.
Klicke auf „Quelle aufnehmen“ oder verwende „Bereich aufnehmen“ für einen Ausschnitt.
Verwende „Stopp“, „Pause“ oder „Fortsetzen“ in der Aufnahmesteuerung.

Reine Audioaufnahmen können nicht pausiert und fortgesetzt werden.

Aufnahmeverhalten anpassen

Wähle eine feste Bildschirmaufnahmerate von 1 bis 120 FPS oder gleiche sie an die Bildwiederholrate des Displays an.
Lege fest, ob der Zeiger sichtbar ist und Klicks hervorgehoben werden.
Aktiviere vor der Aufnahme Systemaudio, Mikrofonaudio oder beides.
Verwende Countdown und automatischen Stopp für einen zeitgesteuerten Anfang oder ein zeitgesteuertes Ende.

Nur Audio aufnehmen

Erteile die Mikrofonberechtigung.
Wähle in den Aufnahmeeinstellungen „Systemstandard“ oder ein bestimmtes Eingabegerät.
Wähle AAC oder ALAC als Format für reine Audioaufnahmen.
Klicke in der Menüleiste auf „Audio“ oder verwende den Kurzbefehle „Nur Audio“.

Reine Audiodateien verwenden die .m4a Dateiendung.

Kameravorschau hinzufügen

Öffne die Aufnahmeeinstellungen oder das Kameramenü der Bereichsauswahl.
Wähle eine Kamera und erteile die Kameraberechtigung.
Wähle die Form Superellipse, Abgerundet oder Quadratisch.
Aktiviere optional „Freistellen“, um die präsentierende Person zu isolieren, oder „Greenscreen“, um einen Chroma-Key-Hintergrund zu entfernen.
Wähle Größe und Spiegelung der Einblendung.
Positioniere die schwebende Vorschau vor oder während der Einrichtung.

Die schwebende Vorschau erscheint in der Aufnahme, wenn sie das Aufnahmeziel überlagert.

Countdown und automatischen Stopp verwenden

Die Bereichsauswahl bietet Countdown-Vorgaben für Aus, 3 Sekunden, 5 Sekunden und 10 Sekunden. Für „Stopp nach“ gibt es Aus, 10 Sekunden, 30 Sekunden, 1 Minute, 5 Minuten und eine eigene Dauer von 0:01 bis 12:00:00.

Wenn du während des Countdowns stoppst, wird er abgebrochen und keine Aufnahme gespeichert.

Anleitung

Spracherkennungshinweise

Diese optionale Funktion achtet am ausgewählten Mikrofon auf anhaltende sprachähnliche Audiosignale und fragt, ob du eine reine Audioaufnahme starten möchtest. Sie ist standardmäßig deaktiviert und erkennt keine Besprechungen, Anrufe, Sprecher, Wörter oder Bedeutungen.

Hinweise aktivieren

Öffne Einstellungen > Aufnahme.
Aktiviere „Bei erkannter Sprache benachrichtigen“.
Lies den Hinweis und wähle dann „Aktivieren“, um zuzustimmen.
Erlaube zuerst Mitteilungen und danach den Mikrofonzugriff.
Wähle „Systemstandard“ oder ein bestimmtes Mikrofon.

Aktiviere „Beim Anmelden öffnen“, wenn die Funktion nach deiner Anmeldung verfügbar sein soll. Die Erkennung funktioniert nur, solange Luxel geöffnet ist.

Entscheide, was geschieht

Wenn Luxel ein Signal erkennt, bietet die Mitteilung „Aufnahme starten“ und „Schließen“ an. „Aufnahme starten“ beginnt genau eine reine Audioaufnahme mit dem ausgewählten Mikrofon. „Schließen“ führt keine Aktion aus; das Öffnen der Mitteilung aktiviert Luxel, ohne aufzunehmen.

Fokusmodi und andere macOS-Mitteilungseinstellungen können den Hinweis verzögern oder ausblenden. Ein Hinweis ist eine Hilfestellung und keine Garantie, dass Luxel ein Gespräch erkennt.

Was Luxel verarbeitet

Solange die Funktion aktiviert ist, analysiert Luxel fortlaufend kurze Mikrofonframes auf deinem Mac. Bevor du ausdrücklich „Aufnahme starten“ auswählst, werden diese Frames verworfen und Luxel erstellt weder Vorlauf noch Mediendatei, Verlaufseintrag, Transkript, Begleitdatei oder Cloud-Upload.

Der Detektor sucht nur nach anhaltenden sprachähnlichen Geräuschen. Er prüft keinen App-Status und entscheidet nicht, ob du dich in einer Besprechung oder einem Anruf befindest.

Automatische Pausen

Luxel pausiert die Mikrofonanalyse während einer aktiven Aufnahme sowie wenn dein Mac gesperrt ist oder das Display schläft. Die Analyse wird automatisch fortgesetzt, wenn die Aufnahme endet oder dein Mac wieder wach und entsperrt ist.

Zugriff deaktivieren oder wiederherstellen

Deaktiviere „Bei erkannter Sprache benachrichtigen“, um die Analyse zu beenden und einen ausstehenden Hinweis zu entfernen. Wurde der Zugriff verweigert, öffne Systemeinstellungen > Datenschutz & Sicherheit > Mikrofon und Systemeinstellungen > Mitteilungen > Luxel. Wähle in den Aufnahmeeinstellungen einen verfügbaren Eingang und aktiviere die Funktion erneut.

Anleitung

Aufzeichnen, was gerade passiert ist

Der Rückblickpuffer hält fortlaufend die letzte Bildschirmhistorie bereit, solange er aktiv ist. Er muss bewusst aktiviert werden, ist in der Menüleiste sichtbar und verwendet dieselbe Berechtigung „Bildschirm- & Systemaudioaufnahme“ wie normale Bildschirmaufnahmen.

Rückblickpuffer einrichten

Öffne „Einstellungen“ > „Rückblickpuffer“.
Aktiviere den Rückblickpuffer und bestätige beim ersten Mal den Einwilligungsdialog.
Wähle eine Länge: 30 Sekunden, 1 Minute, 2 Minuten oder 5 Minuten.
Wähle 24 FPS oder 30 FPS.
Aktiviere „Systemaudio einschließen“ nur, wenn Clips Mac-Audio benötigen.
Lege fest, ob Clips im Editor geöffnet oder an das Schnellexportziel gesendet werden.

Über das Menü verwenden

Starte den Rückblickpuffer über die Steuerung in der Menüleiste.
Warte, bis der Status von „Wird gestartet“ zu „Puffert“ wechselt.
Klicke auf „Exportieren“, um die gewählte letzte Dauer zu speichern.
Mit „Start“ und „Stopp“ schaltest du den Puffer scharf oder aus.
Verwende den Kurzbefehle „Rückblickpuffer-Clip“ oder luxel clip für dieselbe Aktion.

Verhalten und Datenschutz

Der Rückblickpuffer nimmt das Display mit Zeiger auf und speichert dabei temporäre Segmentdateien im Luxel-Cache.
Normale Aufnahmen pausieren den Rückblickpuffer; nach ihrem Ende wird er fortgesetzt.
Der Puffer pausiert aus Systemgründen wie Displayruhezustand, Sperre, Batterie- oder Displayänderungen.
„Beim Start fortsetzen“ ist deaktiviert, bis du es in den Rückblickpuffer-Einstellungen einschaltest.
Clips sind MP4-Dateien mit Namen wie Luxel Replay 2026-07-01 at 14.30.00.mp4.

Wenn du einen Clip erstellst, bevor genug Verlauf vorhanden ist, speichert Luxel den verfügbaren Teil, statt fehlende Zeit zu erfinden.

Bereichsauswahl

Bereich auswählen und verfeinern

Auswahl zeichnen

Klicke auf „Bereich“, um die bildschirmfüllende Auswahlebene zu öffnen. Ziehe einen Bereich auf, ändere ihn mit den Griffen oder wähle mit „Ganzes Display“ das Display aus. Die Mindestauswahl beträgt 32 × 32 Pixel.

Größenvorgaben umfassen 1280 × 720, 1920 × 1080 und 800 × 600. Seitenverhältnisse sind Frei, 16:9, 4:3, 1:1, 9:16 und 21:9.

Nützliche Steuerelemente

Wähle Steuerelemente für Countdown, Stopp nach, Audio, Kamera, Verhältnis und Größe.
Schalte Mikrofon und Kamera um, sofern die Berechtigungen es zulassen.
Nutze die Lupe für präzise Kanten.
Dunkle andere Displays ab oder stelle die letzte Auswahl in den Vorgabeneinstellungen wieder her.
Öffne über die Benachrichtigung die Fokuseinstellungen, wenn du weniger Unterbrechungen möchtest.

Kurzbefehle und Gesten der Bereichsauswahl

Eingabe	Aktion
`Esc`	Bereichsauswahl abbrechen.
`⌘Z`	Eine Auswahländerung widerrufen.
`⌘⇧Z`	Eine Auswahländerung wiederholen.
`⌥click`	Die aktive Schnellaufnahmevorgabe verwenden, wenn eine verfügbar ist.

Anleitung

Aufnahmen bearbeiten und exportieren

Öffnen und prüfen

Nach dem Ende einer normalen Videoaufnahme öffnet Luxel den Editor mit Vorschau, Quelldateiname, Dauer, Abmessungen, Audio- und Alphastatus, geschätzter Dateigröße sowie den Steuerelementen „Original speichern“ und „Exportieren“.

Benenne die Quelldatei direkt um und wechsle zwischen neueren oder älteren Aufnahmen im selben Ordner. Die CLI kann außerdem eine genehmigte Mediendatei öffnen mit luxel editor <file>.

Schneiden, skalieren und Geschwindigkeit ändern

Schneide den Ausgabebereich mit den Start- und Endesteuerelementen der Zeitleiste.
Wähle Original, prozentuale Größenvorgaben oder eine eigene Breite und Höhe.
Verwende „Auf Füllgröße beschneiden“, wenn du die Ausgabegröße anpasst.
Stelle Bildrate und Wiedergabegeschwindigkeit von 0,1× bis 10× ein.
Die Vorschau läuft innerhalb des Schnittbereichs in einer Schleife.

Exportformate auswählen

Format	Hinweise
MP4 (H.264)	Höchstkompatibler Videoexport in der Qualität Kompakt, Ausgewogen oder Hoch.
MP4 (HEVC)	HEVC-Export mit kleinerer Datei in der Qualität Kompakt, Ausgewogen oder Hoch.
MOV (ProRes 422)	Export für Schnitt und Mastering mit fester hoher Qualität und LPCM-Audio.
MOV (ProRes 4444)	Hochwertiger ProRes-Export mit fester hoher Qualität und LPCM-Audio.
GIF	Export als animiertes Bild. Audio entfällt. Unterstützt Schleifen- und Dithering-Optionen.
APNG	Verlustfreier Export als animiertes PNG. Audio entfällt.
WebM (VP9)	WebM-Export in der Qualität Kompakt, Ausgewogen oder Hoch.
MP4 (AV1)	AV1-MP4-Export mit AAC-Audio über den mitgelieferten SVT-AV1-Encoder.

Im Formatmenü lassen sich mehrere Formate wählen; Größen werden angezeigt, wenn Luxel sie berechnen kann. MP4-, MOV-, WebM- und AV1-Exporte verwenden gerade Pixelabmessungen.

Audio anpassen

Mit „Audio einschließen“ kannst du Audio bei unterstützten Formaten stummschalten oder beibehalten.
Stelle den Audiopegel auf 0 % bis 200 % ein.
Aktiviere „Audio normalisieren“, um die Lautstärke beim Export auszugleichen.
Reine Audioquellen lassen sich als M4A, ALAC M4A, WAV, CAF oder FLAC exportieren.

GIF und APNG enthalten niemals Audio.

Aktionen nach dem Export

Während des Exports zeigt Luxel den Fortschritt an und erlaubt den Abbruch. Danach stehen Öffnen, Im Finder anzeigen, Kopie sichern, Öffnen mit, Datei kopieren, Pfad kopieren und Teilen zur Verfügung. Ein Mehrformatexport erstellt einen Stapelordner mit dem Namen der Quellaufnahme.

„Bild kopieren“ und „Bild sichern unter“ verwenden das aktuell pausierte Bild und speichern es als PNG.

Anleitung

Lokale Transkripte erstellen

Luxel transkribiert Aufnahmen mit Audio lokal. Nutze den Editor zur Prüfung oder die CLI, wenn ein Skript Text oder strukturierte Transkriptdaten benötigt.

Für besonders deutliche Transkripte

Verwende Kopfhörer oder AirPods, wenn du Systemaudio und Mikrofon zusammen aufnimmst. Mac-Lautsprecher können denselben Ton ins Mikrofon zurückspielen, wodurch in beiden Quellen doppelter Text entsteht und die Genauigkeit von Transkription und Sprecherzuordnung sinkt.

Im Editor

Öffne eine Aufnahme mit Audio im Editor.
Erstelle oder prüfe den Transkripttext in der Transkriptvorschau.
Durchsuche den Transkripttext oder wähle Passagen aus, um zur entsprechenden Wiedergabestelle zu springen.
Lass „Transkriptbeiträge segmentieren“ für die automatische Gruppierung aktiviert.
Deaktiviere es unter „Einstellungen“ > „Transkripte“, um bei langen Aufnahmen schneller ein Rohtranskript zu erhalten.

Sprecher erkennen und verwalten

Aktiviere „Sprecher erkennen“ unter „Einstellungen“ > „Transkripte“.
Erstelle ein Transkript, um jede erkannte Stimme lokal zu trennen und zu beschriften.
Verwende auf der Sprecherkarte die automatische Erkennung oder stelle eine genaue Sprecherzahl bzw. einen Bereich ein und führe die Erkennung erneut aus.
Spiele Stimmbeispiele ab, benenne einen erkannten Sprecher, speichere ihn als bekannten Sprecher, ordne ihn einem Profil zu oder ignoriere ihn.
Künftige Transkripte können gespeicherte bekannte Sprecher automatisch zuordnen.

Stimmprofile und Sprecherverarbeitung bleiben auf deinem Mac.

Über die Befehlszeile

luxel transcribe demo.m4a > demo.txt
luxel transcribe demo.mp4 --output demo.json --format json --overwrite
luxel transcribe demo.mp4 --locale en_US --semantic-turns --diarize

Standardmäßig wird Klartext auf stdout ausgegeben. Verwende --format json für vollständige, nach Beiträgen segmentierte Transkriptdaten einschließlich Sprecherbeschriftungen, wenn --diarize aktiviert ist.

Arbeitsabläufe

Kombinierte Arbeitsabläufe

Aufnehmen, verfeinern, exportieren, teilen

Nimm ein Display, Fenster oder einen Bereich auf.
Beende die Aufnahme, um den Editor zu öffnen.
Schneide den Bereich und wähle Größe, Bildrate und Geschwindigkeit.
Exportiere als MP4, HEVC, ProRes MOV, GIF, APNG, WebM oder AV1.
Verwende im Menü der exportierten Datei „Pfad kopieren“, „Teilen“ oder „Im Finder anzeigen“.

Schnelles GIF aus einem ausgewählten Bereich

Erstelle eine Exportvorgabe mit dem Format GIF und dem gewünschten Ziel.
Lege sie als Schnellaufnahmevorgabe fest.
Öffne „Bereich“, zeichne eine Auswahl und drücke⌥clickAufnehmen.
Lass die Vorgabe nach der Aufnahme ihre Folgeaktion ausführen.

Eine frühere Aufnahme wiederholen

Aktiviere „Letzte Aufnahme merken“ in den Vorgabeneinstellungen.
Führe einmal eine normale Aufnahme durch.
Verwende „Letzte schnell aufnehmen“ über Kurzbefehle, CLI, URL-Automatisierung oder App-Kurzbefehl.
Nutze für einen neuen Bereich die Schnellaufnahmeaktion der Bereichsauswahl mit der aktiven Schnellvorgabe.

Einen Fehler nachträglich aufnehmen

Aktiviere den Rückblickpuffer vor Beginn der Sitzung.
Wähle je nach benötigtem Verlauf eine Länge von 1, 2 oder 5 Minuten.
Wenn das Problem auftritt, klicke auf „Exportieren“ oder führe luxel clip --seconds 30.
Öffne den Clip im Editor oder lass ihn vom Schnellexportziel verarbeiten.

Übergabe eines pausierten Bildes

Öffne eine Aufnahme im Editor.
Pausiere bei dem benötigten Bild.
Verwende „Bild kopieren“ oder „Bild sichern unter“ in den Editoraktionen.
Nutze das gespeicherte PNG oder das Bild aus der Zwischenablage in der Ziel-App.

Skriptgesteuerter Export und Transkription

Installiere die CLI aus ihrem GitHub-Repository und führe dann luxel pair.
Führe luxel convert demo.mp4 demo.webm --width 1280 --height 720.
Verwende luxel convert demo.mp4 demo-av1.mp4 --format av1 aus, wenn du MP4 AV1 benötigst.
Führe luxel transcribe demo.mp4 --output demo.txt.
Verwende --format json für Transkriptdaten oder global --json für das vollständige Terminalergebnis.

Referenz

Tastaturkurzbefehle

Öffne „Einstellungen“ > „Kurzbefehle“, um Kurzbefehle zu aktivieren, zu suchen, zu bearbeiten, zurückzusetzen oder zu löschen. Eigene Kurzbefehle müssen eine Taste und mindestens eine Sondertaste verwenden.

Befehl	Standardkurzbefehl	Ergebnis
Bereich auswählen	`⌘⌃⌥R`	Bereichsauswahl für eine Aufnahme öffnen.
Aufnahme umschalten	`⌘⌃⌥T`	Eine aktive Aufnahme beenden oder mit dem Standardziel starten.
Aktives Fenster aufnehmen	`⌘⌃⌥⇧W`	Das derzeit aktive Fenster aufnehmen.
Vollbild aufnehmen	`⌘⌃⌥⇧F`	Das Hauptdisplay aufnehmen.
Nur Audio	`⌘⌃⌥A`	Eine reine Audioaufnahme starten.
Letzte schnell aufnehmen	`⌘⌃⌥Q`	Die gemerkte letzte Aufnahme mit der Schnellvorgabe verwenden.
Rückblickpuffer-Clip	`⌘⌃⌥C`	Den letzten Rückblickpuffer speichern, wenn er aktiv ist.

Konfliktwarnungen

Luxel warnt vor doppelten Kurzbefehlen und bekannten macOS-Aufnahmekurzbefehlen.

⌘⇧3⌘⇧4⌘⇧5⌘⇧6⌘⌃⇧3⌘⌃⇧4

Referenz

Befehlszeilenwerkzeug

Verwende luxel für Aufnahmen, Rückblickclips, Konvertierung, Export und Transkription in Skripten oder wiederholbaren Arbeitsabläufen. Die eigenständige CLI sendet authentifizierte Anfragen an die Luxel-App; Luxel erledigt sämtliche Aufnahme- und Medienarbeit.

Installieren

Installiere die neueste luxel Version über das Terminal:

curl -fsSL https://luxel.media/cli/install.sh | sh

Das Installationsprogramm prüft die Prüfsumme der Version, fügt luxel zu ~/.local/binhinzu und aktualisiert deinen Shell-Pfad. Öffne nach der Installation ein neues Terminal.

CLI-Quellcode und README

Mit Luxel koppeln

luxel pair
luxel doctor

Beim Koppeln erscheint in Luxel ein sichtbarer Genehmigungsdialog. App und CLI speichern getrennte Kopien der Anmeldedaten im macOS-Schlüsselbund. In „Einstellungen“ > „Befehlszeile“ kannst du die Steuerung jederzeit deaktivieren oder einen gekoppelten Client widerrufen.

Häufige Beispiele

luxel record --display main --fps display --countdown 3
luxel record --active-window --fps 120
luxel toggle --last-area
luxel stop
luxel clip --seconds 30
luxel latest --reveal
luxel preferences

Medienbeispiele

luxel record --active-window --preset "Default" --save-to ~/Movies/Luxel
luxel editor ~/Movies/demo.mp4
luxel convert demo.mp4 demo.webm
luxel convert demo.mp4 demo-av1.mp4 --format av1
luxel convert demo.mp4 demo.gif --start 2 --duration 5 --fps 15 --width 800 --height 450
luxel convert demo.mp4 demo.mov --format prores422 --quality high
luxel export request.json output.webm --overwrite --json
luxel transcribe demo.m4a > demo.txt
luxel transcribe demo.mp4 --output demo.json --format json --diarize --overwrite

Agent-Skills

Installiere Luxel Skills, damit kompatible Coding-Agenten die vollständige CLI verwenden oder gezielte WebM-Nachweise für Reviews erstellen können.

npx skills add https://github.com/rawcontext/luxel-skills
npx skills add https://github.com/rawcontext/luxel-skills --skill luxel
npx skills add https://github.com/rawcontext/luxel-skills --skill luxel-evidence

Wähle luxel für Befehlsreferenz und Bedienung oder luxel-evidence für einen gezielten Aufnahme- und Anhangsworkflow.

Luxel Skills auf GitHub ansehen.

Befehle

Befehl	Funktion
`luxel --version`	Die Luxel-CLI-Version ausgeben.
`luxel pair [--name <name>]`	Diese CLI über eine sichtbare Genehmigung in der App mit Luxel koppeln.
`luxel record`	Eine Aufnahme von einem Display, dem aktiven Fenster oder dem zuletzt gewählten Bereich starten.
`luxel stop`	Die aktive Aufnahme beenden.
`luxel toggle`	Die aktive Aufnahme beenden oder eine starten, wenn ein Ziel angegeben ist.
`luxel clip`	Den Rückblickpuffer als Clip speichern.
`luxel latest`	Die neueste Aufnahme öffnen oder im Finder anzeigen.
`luxel editor <file>`	Eine genehmigte Mediendatei im Luxel-Editor öffnen.
`luxel convert <input> <output>`	Medien mit Luxel konvertieren oder bearbeiten.
`luxel export <request-json> <output>`	Aus einer JSON-Datei mit einer Luxel-Exportanfrage exportieren.
`luxel transcribe <file>`	Eine Medien- oder Audiodatei lokal mit Luxel transkribieren.
`luxel preferences [--pane <pane>]`	Luxel-Einstellungen öffnen.
`luxel access add <path>`	Luxel einen Ordner in der nativen Ordnerauswahl genehmigen lassen.
`luxel access check <path>`	Prüfen, ob Luxel einen Pfad verwenden kann.
`luxel access list`	Integrierte, Aufnahme- und zusätzliche Ordnerfreigaben auflisten.
`luxel access revoke <grant-id>`	Eine zusätzliche Ordnerfreigabe entfernen.
`luxel doctor`	App-, Kopplungs-, Berechtigungs- und Ordnerstatus melden.
`luxel cancel <job-id>`	Einen aktiven Befehlszeilenauftrag abbrechen.

Befehlsdetails

record benötigt genau ein Ziel: --display, --active-windowoder --last-area.
record --fps und toggle --fps akzeptieren eine ganze Zahl von 1 bis 120 oder display zum Anpassen an die Bildwiederholrate.
toggle beendet eine aktive Aufnahme, wenn kein Ziel übergeben wurde. Beim Start erfordern zielbezogene Optionen ein Ziel.
clip verwendet die konfigurierte Länge des Rückblickpuffers, sofern nicht --seconds übergeben wird.
latest --reveal zeigt die neueste Aufnahme im Finder an, statt sie zu öffnen.
preferences öffnet die Luxel-Einstellungen. --pane akzeptiert general, presets, shortcuts, updatesoder about als URL-Hinweis, Luxel öffnet die Einstellungen jedoch im Standardbereich.
convert leitet das Format aus der Ausgabeerweiterung ab, aber .mov erfordert --format prores422 oder --format prores4444, .m4a erfordert --format m4a oder --format alacund MP4 AV1 erfordert --format av1.
export akzeptiert ein JSON-Dokument mit einer Luxel-Exportanfrage für Felder ohne eigene Optionen.
Alle Befehle warten auf ein Terminalergebnis. Verwende --timeout zum Ändern des Zeitlimits, --json für eine strukturierte Ausgabe oder --quiet zum Unterdrücken erfolgreicher Ausgaben.

Ordnerzugriff

Luxel kann deinen Filme-Ordner, den konfigurierten Aufnahmeordner und in der App genehmigte Ordner verwenden. Ein Terminalpfad umgeht niemals die App Sandbox.

luxel access add ~/Desktop/Exports
luxel access check ~/Desktop/Exports/demo.mp4
luxel access list
luxel access revoke <grant-id>

access add öffnet die Ordnerauswahl von Luxel. Der dort ausgewählte Ordner ist der Ordner, für den die App eine Zugriffsberechtigung erhält.

Sicherheit und Datenschutz

Jeder Aufruf verwendet eine authentifizierte, kurzlebige Verbindung auf127.0.0.1. Luxel weist nicht gekoppelte Clients, veraltete Anfragen, wiederholte Nonces, veränderte Anfrageinhalte und Nicht-Loopback-Endpunkte ab. Die CLI erhält nie Luxels sicherheitsbezogene Lesezeichen und verarbeitet selbst keine Medien.

Aufnahme- und Rückblickoptionen

Option	Bedeutung
`--display <target>`	Ein Display aufnehmen. Verwende main oder übergib eine Displaykennung.
`--active-window`	Das aktive Fenster aufnehmen.
`--last-area`	Den zuletzt gewählten Bereich aufnehmen.
`--preset <name>`	Eine Luxel-Exportvorgabe für die Schnellaufnahme verwenden.
`--fps <1-120\|display>`	Eine feste Aufnahmebildrate verwenden oder an die Bildwiederholrate des Displays anpassen.
`--countdown <seconds>`	Vor Aufnahmebeginn 0 bis 60 Sekunden warten.
`--save-to <directory>`	In einem für Luxel zugänglichen Ordner speichern.
`--seconds <seconds>`	Mit luxel clip eine bestimmte Dauer des Rückblickpuffers speichern.

Konvertierungsoptionen

Option	Bedeutung
`--format <format>`	Verwende gif, hevc, mp4, av1, webm, apng, prores422, prores4444, m4a, alac, wav, caf oder flac.
`--width <pixels> --height <pixels>`	Die Exportgröße ändern. Verwende beide Optionen zusammen.
`-s <width>x<height>`	Mit einer kompakten Größenoption skalieren.
`--fps <frames>, -r <frames>`	Die Ausgabebildrate festlegen.
`--start <seconds>, --ss <seconds>`	Den Anfang des Exportbereichs festlegen.
`--end <seconds>, --to <seconds>`	Eine eindeutige Endzeit festlegen.
`--duration <seconds>, --t <seconds>`	Eine Dauer ab der Startzeit festlegen.
`--speed <value>`	Die Wiedergabegeschwindigkeit von 0,1 bis 10 festlegen.
`--mute, -an`	Ohne Audio exportieren.
`--crop-to-fill`	Die Ausgabegröße durch Beschneiden füllen.
`--crop <x,y,width,height>`	Ein eindeutiges Beschneidungsrechteck verwenden.
`--quality <quality>`	Je nach Format compact, balanced, high oder lossless verwenden.
`--overwrite, -y`	Eine vorhandene Ausgabedatei ersetzen.

Transkriptionsoptionen

Option	Bedeutung
`--locale <identifier>`	Mit einem bestimmten Gebietsschema transkribieren. Standard ist das aktuelle Gebietsschema.
`--output <file>`	Die Transkriptausgabe in eine Datei statt auf stdout schreiben.
`--semantic-turns`	Automatische Gruppierung von Beiträgen verwenden.
`--diarize`	Sprecher mit Luxels mitgeliefertem lokalen Diarisierungsmodell erkennen und beschriften.
`--format <text\|json>`	Klartext oder vollständiges Transkript-JSON wählen.
`--overwrite, -y`	Eine bereits vorhandene Transkriptausgabedatei ersetzen.

Globale Optionen

Option	Bedeutung
`--json`	Das Terminalergebnis als JSON ausgeben.
`--quiet`	Erfolgreiche Ausgabe unterdrücken.
`--timeout <seconds>`	Festlegen, wie lange auf Luxel gewartet wird. Standard sind 3600 Sekunden.
`--help`	Hilfe zum aktuellen Befehl anzeigen.

Ausgabe und Exitstatus

Die Klartextausgabe zeigt Transkripttext, einen Ausgabepfad, eine Aufnahme-ID oder ein kurzes Statusdokument. --json gibt das vollständige Terminalereignis aus. Exitstatus0 bedeutet Erfolg; 2 steht für ungültige Verwendung; 3 bedeutet nicht gekoppelt; 4 bedeutet, dass Luxel nicht geöffnet werden konnte; 5 steht für einen Fehler der Schlüsselbund-Anmeldedaten; 6 steht für einen Berechtigungs- oder Ordnerzugriffsfehler;7 steht für einen App-, Protokoll-, E/A- oder JSON-Fehler; 8 steht für eine Zeitüberschreitung und 130 für einen Abbruch.

Referenz

Export- und Konvertierungsformate

Der Editor bietet Video- und Animationsformate für Bildschirmaufnahmen sowie reine Audioformate für Audioquellen. Die CLI stellt Skripten dieselben Konvertierungsoptionen bereit und lässt Luxel die Verarbeitung ausführen.

Format	Codec oder Container	Hinweise
MP4	H.264-Video	Höchstkompatibler Videoexport. Unterstützt Kompakt, Ausgewogen und Hoch.
HEVC MP4	HEVC-Video	Kleinerer Videoexport. Unterstützt Kompakt, Ausgewogen und Hoch.
ProRes 422 MOV	Apple ProRes 422	Export für Schnitt und Mastering mit fester hoher Qualität und LPCM-Audio.
ProRes 4444 MOV	Apple ProRes 4444	Hochwertiger ProRes-Export mit fester hoher Qualität und LPCM-Audio.
GIF	Animiertes Bild	Audio entfällt. Unterstützt Schleifen und animationsbezogene Exportoptionen.
APNG	Animiertes PNG	Verlustfreier Export als animiertes Bild. Audio entfällt.
WebM	VP9 WebM	WebM-Export. Unterstützt Kompakt, Ausgewogen und Hoch.
MP4 (AV1)	AV1-Video mit AAC-Audio	AV1-MP4-Export über den mitgelieferten SVT-AV1-Encoder.
M4A	AAC-Audio	Reines Audioformat für Editor- und Befehlszeilenkonvertierung.
ALAC M4A	Apple Lossless Audio	Verlustfreies reines Audioformat für Editor- und Befehlszeilenkonvertierung.
WAV	PCM-Audio	Unkomprimiertes reines Audioformat für Editor- und Befehlszeilenkonvertierung.
CAF	Core Audio Format	Apple-Format für reine Audiokonvertierung im Editor und auf der Befehlszeile.
FLAC	Free Lossless Audio Codec	Verlustfreies reines Audioformat für Editor- und Befehlszeilenkonvertierung.

Formatregeln

GIF und APNG enthalten kein Audio. MP4-, MOV-, WebM- und AV1-Exporte verwenden gerade Pixelabmessungen. ProRes wird als MOV, WebM mit VP9 und AV1 als MP4 ausgegeben.

Referenz

URL-Automatisierung und App-Kurzbefehle

URL-Schema

Luxel registriert das luxel:// URL-Schema. Das Starten von Aufnahmen und Erstellen von Rückblickclips kann eine Bestätigung erfordern, sofern der Aufrufer nicht berechtigt wurde; Befehle wie stop, preferences und latest sind standardmäßig erlaubt.

luxel://record?target=display&display=main&fps=display&countdown=3
luxel://record?target=activeWindow&preset=Default
luxel://toggle
luxel://stop
luxel://clip?seconds=30
luxel://preferences
luxel://latest?reveal=true

x-callback-URLs

Automatisierungsbefehle akzeptieren x-success und x-error Callback-URLs. Erfolgreiche dateierzeugende Befehle hängen filePathan, Aufnahmevorgänge hängen recordingIDan und Fehler hängen errorMessage.

Verwende das URL-Schema direkt für x-callback-Automatisierung.

App-Kurzbefehle

Luxel enthält App-Kurzbefehle für Aufnahme starten, Aufnahme stoppen, Aufnahme umschalten, Rückblickpuffer-Clip und Neueste Aufnahme abrufen. Starten und Umschalten können Ziel-, Vorgaben- und Countdownwerte annehmen; Rückblickpuffer-Clip kann Sekunden annehmen; Neueste Aufnahme abrufen kann die Datei im Finder anzeigen. Zu den Phrasen gehören „Eine Aufnahme mit Luxel starten“, „Luxel stoppen“, „Luxel umschalten“, „Rückblickpuffer mit Luxel als Clip speichern“ und „Meine neueste Luxel-Aufnahme anzeigen“.

Referenz

Einstellungen

Bereich	Steuert
Aufnahme	Cursoranzeige, Klickmarkierungen, 1–120 FPS oder an das Display angepasste Aufnahme, Systemaudio, Mikrofon-Audio, Nur-Audio-Format, Mikrofonauswahl, optionale Spracherkennungshinweise und Kamera-Overlay-Steuerung einschließlich Form, Hintergrundentfernung, Größe und Spiegelung.
Ausgabe	Aufnahmeordner, Exportwiederholung und ob Luxel vor dem Verwerfen einer Aufnahme nachfragt.
Vorgaben	Schnellexportvorgaben, Größen der Bereichsauswahl, Lupenverhalten, Abdunklung und Wiederherstellung der letzten Auswahl.
Tastaturkurzbefehle	Aktivierung globaler Kurzbefehle, Kurzbefehlsuche, Bearbeitung eigener Kurzbefehle, Zurücksetzen/Löschen und Konfliktwarnungen.
Notch	Steuerung der integrierten Notch, Schnellaktionen im Leerlauf, Aufnahmewellenform, Zeitpunkt des automatischen Einklappens und schwebendes HUD als Alternative.
Wiedergabepuffer	Aktivierung, Pufferlänge, Displayquelle mit Zeiger, Bildrate, Systemaudio, Fortsetzen beim Start und Clipziel.
Transkripte	Transkriptsprache, Beitragssegmentierung, lokale Sprechererkennung und gespeicherte Stimmprofile bekannter Sprecher.
Befehlszeile	Befehlszeilensteuerung aktivieren, CLI-Repository öffnen, gekoppelte Clients prüfen, Zugriff widerrufen und genehmigte Ordner verwalten.
System	Menüleisten-Timer, Benachrichtigungen, Start bei Anmeldung, Aktualisierungseinstellungen und Danksagungen.

Schnellvorgaben

Exportvorgaben können hinzugefügt, dupliziert, gelöscht, umbenannt und als Schnellaufnahmevorgabe festgelegt werden. Sie unterstützen Format, Größenregel, Bildrate, Ziel und Folgeaktion. Ziele sind der Aufnahmeordner oder die Zwischenablage. Schnellvorgaben bieten GIF, MP4, HEVC MP4, ProRes 422 MOV, ProRes 4444 MOV und APNG; WebM und AV1 bleiben im Editor und über die CLI verfügbar.

Wiedergabepuffer

Die Rückblickpuffer-Einstellungen steuern Aktivierung, Cliplänge, 24 oder 30 FPS, Systemaudio, Fortsetzen beim Start und ob Clips im Editor oder am Schnellexportziel geöffnet werden.

Befehlszeile

Die Befehlszeileneinstellungen aktivieren die externe Steuerung, öffnen das CLI-Repository, widerrufen gekoppelte Clients und verwalten Ordner für Befehlszeilenanfragen.

Systemverhalten

Die Systemeinstellungen umfassen Menüleisten-Timer, Benachrichtigungen, Start bei Anmeldung, Aktualisierungen und Danksagungen.

Referenz

Sprachen

Für die Luxel-Oberfläche und Systemberechtigungsdialoge stehen 11 Sprachen zur Verfügung.

Unterstützte Gebietsschemata

Englisch
Deutsch (Deutschland)
Spanisch (Spanien)
Französisch (Frankreich)
Italienisch (Italien)
Japanisch (Japan)
Koreanisch (Südkorea)
Vietnamesisch
Chinesisch (vereinfacht)
Portugiesisch (Brasilien)
Portugiesisch (Portugal)

Berechtigungsdialoge

Kamera-, Mikrofon-, Bildschirmaufnahme- und Spracherkennungsdialoge erscheinen in der ausgewählten Sprache. Luxel fragt jede Berechtigung nur an, wenn die passende Funktion aktiviert oder eine Aufnahme gestartet wird.

Luxel folgt automatisch der Spracheinstellung von macOS.

Hilfe

Fehlerbehebung

Luxel fragt immer wieder nach der Bildschirmberechtigung

Vergewissere dich, dass du jedes Mal dieselbe Luxel-Kopie öffnest. Beende Luxel nach einer Änderung der Berechtigung „Bildschirm- & Systemaudioaufnahme“ und öffne es erneut.

Aufnahmetasten sind deaktiviert

Wähle ein Aufnahmeziel und behebe die sichtbaren Berechtigungshinweise. Bildschirmaufnahmen benötigen „Bildschirm- & Systemaudioaufnahme“, reine Audioaufnahmen die Mikrofonberechtigung.

Bildschirmaufnahme schlägt trotz Berechtigung fehl

Beende Luxel nach einer Änderung der Berechtigung „Bildschirm- & Systemaudioaufnahme“ und öffne es erneut. Ist Luxel weiterhin nicht aufgeführt, entferne alte Luxel-Einträge aus der Berechtigungsliste und öffne Luxel erneut.

Mikrofonaudio fehlt

Aktiviere „Mikrofon aufnehmen“, wähle ein gültiges Mikrofon oder „Systemstandard“ und erteile die Mikrofonberechtigung. GIF- und APNG-Exporte enthalten kein Audio.

Die Spracherkennung hört nicht zu

Öffne die Aufnahmeeinstellungen und stelle sicher, dass „Bei erkannter Sprache benachrichtigen“ aktiviert ist. Erlaube Mitteilungen und Mikrofonzugriff, wähle ein verfügbares Mikrofon und stelle sicher, dass Luxel geöffnet ist, keine Aufnahme läuft und dein Mac wach und entsperrt ist.

Eine Spracherkennungsmitteilung wurde nicht angezeigt

Öffne Systemeinstellungen > Mitteilungen > Luxel und erlaube Mitteilungen. Fokusmodi und andere macOS-Mitteilungseinstellungen können Hinweise verzögern oder ausblenden. Die Spracherkennung dient nur als Signal und erkennt nicht garantiert jedes Gespräch, jede Besprechung oder jeden Anruf.

Das ausgewählte Mikrofon ist nicht verfügbar

Öffne die Aufnahmeeinstellungen und wähle „Systemstandard“ oder einen anderen verbundenen Eingang. Luxel verwendet das ausgewählte Mikrofon sowohl für Aufnahmen als auch für die Spracherkennung.

Schnellaufnahme ist deaktiviert

Erstelle oder wähle eine Schnellexportvorgabe und anschließend ein Ziel oder aktiviere „Letzte Aufnahme merken“, damit Luxel eine frühere Aufnahme wiederholen kann.

„Bild kopieren“ oder „Bild sichern unter“ ist deaktiviert

Pausiere zuerst die Vorschau. Einzelbilder verwenden das aktuell pausierte Bild und werden als PNG gespeichert.

Kurzbefehl wird nicht ausgeführt

Vergewissere dich, dass Tastaturkurzbefehle aktiviert sind, entferne Duplikate und vermeide bekannte macOS-Aufnahmekurzbefehle, darunter:

⌘⇧3⌘⇧4⌘⇧5⌘⇧6⌘⌃⇧3⌘⌃⇧4

Die Notch-Steuerung ist nicht sichtbar

Luxel verwendet die integrierte Notch, wenn ein Display mit Notch erkannt wird und die Notch-Einstellung aktiviert ist. Andernfalls wird bei aktivierter Alternative das schwebende HUD oder nur der Menüleistenstatus verwendet.

Rückblickpuffer kann nicht starten

Aktiviere den Rückblickpuffer, erteile die Berechtigung „Bildschirm- & Systemaudioaufnahme“ und stelle sicher, dass keine normale Aufnahme aktiv ist. Luxel pausiert den Puffer während regulärer Aufnahmen.

Rückblickclips sind kürzer als angefordert

Der Puffer kann nur bereits vorhandenen Verlauf exportieren. Warte, bis das Menü den Rückblickpuffer als aktiv meldet, bevor du die vollständige gewählte Dauer speicherst.

Der Befehl luxel wurde nicht gefunden

Installiere die CLI aus dem Luxel-CLI-Repository auf GitHub und lege die luxel-Binärdatei in einem Verzeichnis deines PATH ab.

CLI-Transkription schlägt fehl

Führe luxel doctor aus, bestätige, dass Transkription in der App verfügbar ist, und prüfe Luxels Zugriff auf Ein- und Ausgabeordner.

Hilfe

Häufige Fragen

Wo werden Aufnahmen gespeichert?

Standardmäßig werden Aufnahmen in ~/Movies/Luxelgespeichert. Ändere den Ordner unter „Einstellungen“ > „Ausgabe“.

Kann ich Audio in GIF oder APNG exportieren?

Nein. GIF und APNG sind in Luxel animierte Bildformate und enthalten kein Audio. Verwende MP4, HEVC MP4, ProRes MOV, WebM oder AV1, wenn Audio benötigt wird.

Wie funktioniert die Kameravorschau?

Wähle eine Kamera in den Aufnahmeeinstellungen oder der Bereichsauswahl. Luxel zeigt eine schwebende Kameravorschau, die im aufgenommenen Bereich erscheinen kann. Wähle Superellipse, Abgerundet oder Quadratisch, eine kleine, mittlere oder große Größe und die Spiegelung. „Freistellen“ entfernt den Hintergrund um die präsentierende Person, „Greenscreen“ einen Chroma-Key-Hintergrund.

Kann ich reine Audioaufnahmen exportieren?

Ja. Reine Audioaufnahmen werden als .m4a mit AAC oder ALAC gespeichert. Editor und CLI können reine Audioquellen als M4A, ALAC M4A, WAV, CAF oder FLAC exportieren.

Kann ich Luxel über Skripte steuern?

Ja. Verwende den Befehl luxel für Shell-Arbeitsabläufe oder das luxel:// URL-Schema aus Apps, die URLs öffnen können.

Nimmt der Rückblickpuffer ständig auf?

Nein. Der Rückblickpuffer bleibt aus, bis du ihn aktivierst. Solange er aktiv ist, ist er in der Menüleiste sichtbar und kann über dieselbe Steuerung beendet werden.

Kann ich Luxel verwenden, ohne den Editor zu öffnen?

Ja. Schnellexporte, Ziele für Rückblickclips, luxel convert, luxel exportund luxel transcribe können direkt abgeschlossen werden.

Welche Sprachen sind lokalisiert?

Luxel enthält Englisch, Deutsch, Spanisch, Französisch, Italienisch, Japanisch, Koreanisch, Vietnamesisch, vereinfachtes Chinesisch, Portugiesisch (Brasilien) und Portugiesisch (Portugal).