AirCheck Ratgeber · Support · Start · English

Ratgeber / Internes Audio und Systemaudio aufnehmen

Mac-Systemaudio im Terminal aufnehmen

Getestet auf macOS 26.4.1 (Tahoe), Apple M3 Max, 3. Sept. 2026. Aktualisiert am 17. Sept. 2026.

Kein Terminal-Werkzeug unter macOS nimmt Systemaudio von sich aus auf. ffmpeg -f avfoundation, SoX rec und screencapture -g lesen alle Core-Audio-Eingabegeräte, und die Ausgabe des Mac ist keines davon. Auf dem Test-Mac listete ffmpeg 8.1.1 vier Audiogeräte auf, alle Eingänge. Um die Systemausgabe von der Kommandozeile aus aufzunehmen, leitest du sie zuerst in ein virtuelles Gerät wie BlackHole und nimmst dann dieses Gerät auf.

Kann ffmpeg auf dem Mac Systemaudio aufnehmen?

Nicht direkt. Der Aufnahmeeingang von ffmpeg unter macOS ist avfoundation, das die ffmpeg-Dokumentation als „das derzeit von Apple empfohlene Framework für Streamgrabbing unter OSX“ beschreibt. AVFoundation listet Aufnahmegeräte auf. Führe den Listenbefehl unter macOS 26.4.1 mit ffmpeg 8.1.1 aus:

ffmpeg -f avfoundation -list_devices true -i ""

Ausgabe auf dem Test-Mac, Audio-Abschnitt: [0] Serato Virtual Audio, [1] iPhone Microphone, [2] MacBook Pro Microphone, [3] Microsoft Teams Audio. Video-Abschnitt: FaceTime HD Camera, zwei iPhone-Kameras und Capture screen 0. Es gibt keinen Eintrag „Systemausgabe“ oder „Lautsprecher“, und Capture screen 0 liefert nur Video. Zwei der vier Audioeinträge sind virtuelle Geräte, die Serato und Teams installiert haben, und genau das ist der Hinweis: Der einzige Weg, auf dem etwas, das der Mac abspielt, bei ffmpeg ankommt, führt über ein virtuelles Gerät, das die Ausgabe als Eingang bereitstellt.

ScreenCaptureKit, die API, die unter macOS 13 oder neuer tatsächlich Systemaudio erfasst, hat kein ffmpeg-Eingabegerät. Siehe was ScreenCaptureKit-Audioaufnahme ist.

Welche Terminal-Befehle funktionieren für die Aufnahme von Audioeingängen?

Alle drei Werkzeuge eignen sich für Mikrofone und Audio-Interfaces. Ersetze den Index durch den aus deiner Geräteliste.

  • ffmpeg, 24-Bit-WAV mit 48 kHz von Audiogerät 2: ffmpeg -f avfoundation -i ":2" -ar 48000 -c:a pcm_s24le take.wav. Der Doppelpunkt bedeutet „kein Videogerät“. Wenn du möchtest, kannst du statt des Index im Dateinamen -audio_device_index 2 verwenden.
  • SoX: rec take.wav. Laut SoX-Handbuch wird beim Aufruf als rec „das Standard-Audiogerät als Eingabequelle verwendet“, und die Umgebungsvariable AUDIODEV überschreibt dieses Gerät. SoX ist unter macOS nicht installiert, es kommt über Homebrew.
  • screencapture (integriert): screencapture -v -g take.mov. Die Man-Page unter macOS 26.4.1 dokumentiert -g als „nimmt während einer Videoaufnahme Audio über den Standardeingang auf“ und -G <id> für einen bestimmten Eingang. Wieder ein Eingang, und das Ergebnis ist eine Videodatei.

Geräteindizes verschieben sich, wenn Geräte kommen und gehen. Ein Skript, das gestern lief, kann heute das falsche Gerät aufnehmen. Aus diesem Grund akzeptiert -audio_device_id von ffmpeg eine stabile uid:- oder serial:-Kennung.

Wie leitet man Systemaudio mit BlackHole in ffmpeg?

Installiere ein virtuelles Gerät, schicke die Ausgabe des Mac dorthin und nimm es als Eingang auf.

  1. Installiere BlackHole 2ch (kostenlos, GPL-3.0) von den GitHub-Releases.
  2. Öffne Audio-MIDI-Setup, klicke auf +, Gerät mit mehreren Ausgängen erstellen, hake deine Lautsprecher und BlackHole 2ch an. Klicke mit der rechten Maustaste darauf und wähle „Dieses Gerät für die Tonausgabe verwenden“. Ohne diesen Schritt bleibt dein Mac während der Aufnahme stumm.
  3. Liste die Geräte erneut auf, notiere den Audio-Index von BlackHole und dann: ffmpeg -f avfoundation -i ":<index>" -ar 48000 -c:a pcm_s24le system.wav.
  4. Drücke q im Terminal, um zu stoppen.

Zwei typische Fehler. Erstens: Die Aufnahme ist stumm, weil das Gerät mit mehreren Ausgängen nicht die aktive Ausgabe ist oder weil BlackHole mit einer anderen Abtastrate (Samplerate) läuft als die Lautsprecher; stelle jedes Gerät im Gerät mit mehreren Ausgängen auf 48 kHz. Zweitens: Der Index hat sich geändert, nachdem ein Headset oder Interface angeschlossen wurde; liste vor jeder Sitzung neu auf. Die vollständige Treibereinrichtung steht in Gerät mit mehreren Ausgängen erstellen, das spätere Entfernen in BlackHole deinstallieren.

Wann ist das Terminal dafür das falsche Werkzeug?

Bei langen oder unbeaufsichtigten Aufnahmen. ffmpeg nimmt von einem festen Gerät auf, solange dieses Gerät existiert und der Prozess läuft; es gibt keinen Watchdog, keine Logik zum Neuverbinden und kein Konzept für ein Gerät, das verschwunden ist und unter einer neuen Core-Audio-ID zurückkommt. Fällt ein USB-Interface in Stunde zwei eines DJ-Sets aus, endet die Aufnahme dort. Ein grafischer Recorder mit Wiederverbindung fängt das ab: AirCheck prüft alle 2 Sekunden, ob Buffer ankommen, startet die Aufnahme nach 5 Sekunden Stille in dieselbe Datei neu und findet ein neu angeschlossenes Gerät anhand seines Namens wieder.

Das Terminal ist das richtige Werkzeug für geskriptete, kurze Aufnahmen eines bekannten Eingangs, für Stapelkonvertierung (ffmpeg und das mit macOS mitgelieferte afconvert beherrschen beide WAV-, AIFF- und MP3-Konvertierungen) und für Macs ohne Bildschirm. Es ist das falsche Werkzeug für „nimm die nächsten drei Stunden alles auf, was läuft“, und ohne Treiberinstallation kommt es nicht an Systemaudio heran.

AVFoundation ist das derzeit von Apple empfohlene Framework für Streamgrabbing unter OSX >= 10.7 sowie unter iOS.

FFmpeg documentation, ffmpeg-devices (avfoundation)

Audioaufnahme über die Kommandozeile unter macOS 26.4.1 (Sept. 2026)

WerkzeugNimmt Eingänge aufNimmt Systemausgabe allein aufMit BlackHoleAusgabeformatIn macOS enthalten
ffmpeg -f avfoundationjaneinjaWAV, AIFF, MP3, beliebignein (Homebrew)
sox / recjaneinjaWAV, AIFF, weiterenein (Homebrew)
screencapture -v -gjaneinjaMOV-Videoja
AirCheck (GUI)jaja (ScreenCaptureKit)nicht nötigWAV, MP3nein (39 €)

Die Geräteliste auf dem Test-Mac zeigte nur Eingabe- und virtuelle Geräte, keinen Eintrag für die Systemausgabe.

Wo AirCheck passt

AirCheck ist die grafische Antwort auf das Problem dieser Seite: Es erfasst die Systemausgabe über ScreenCaptureKit ohne Treiber, ohne Gerät mit mehreren Ausgängen und ohne Index, der sich verschiebt, und exportiert WAV oder MP3 nach ~/Music/AirCheck. Es setzt macOS 14 oder neuer voraus und kostet 39 € einmalig. Bei Interface-Aufnahmen ergänzt es, was ffmpeg bei langen Aufnahmen fehlt: einen Watchdog, der die Aufnahme in dieselbe Datei neu startet und ein neu angeschlossenes Gerät anhand seines Namens wiederfindet.

Wann du es nicht brauchst: Wenn du eine kurze Aufnahme von einem bekannten Mikrofon oder Interface skriptest, sind ffmpeg oder rec kostenlos und skriptfähig, und AirCheck bringt nichts zusätzlich. Wenn du eine per cron gesteuerte Aufnahme ohne Bildschirm brauchst, bleib im Terminal.

AirCheck nimmt auf, was dein Mac abspielt, oder jedes Eingabegerät, in eine Datei. 39 € einmalig.

AirCheck kaufen, 39 €

macOS 14 oder neuer. Einmalige Zahlung. 14 Tage Rückgaberecht, ohne Nachfragen.

Häufige Fragen

Sieht der avfoundation-Eingang von ffmpeg ScreenCaptureKit-Audio?

Nein. ffmpeg hat kein ScreenCaptureKit-Audioeingabegerät. Sein avfoundation-Eingang listet AVFoundation-Aufnahmegeräte auf, auf dem Test-Mac zwei Mikrofone und zwei von Serato und Teams installierte virtuelle Geräte, aber nichts, was die Systemausgabe repräsentiert.

Kann screencapture Systemaudio von der Kommandozeile aufnehmen?

Nein. Die Man-Page von macOS 26.4.1 dokumentiert -g als Audioaufnahme „über den Standardeingang“ während einer Videoaufnahme. Es nimmt ein Mikrofon in eine MOV-Datei auf, nicht die Ausgabe des Mac.

Welche Abtastrate soll ich ffmpeg für eine Mac-Aufnahme übergeben?

Passend zum Gerät: 48 kHz für die meisten Interfaces und für alles, was über ein auf 48 kHz eingestelltes BlackHole läuft. Füge -ar 48000 und -c:a pcm_s24le hinzu, um ein 24-Bit-WAV zu erhalten, das dem entspricht, was ScreenCaptureKit-Recorder erzeugen.

Gibt es unter macOS einen integrierten Kommandozeilen-Audiorecorder?

Nur screencapture, das Video plus ein Eingabegerät aufnimmt. macOS liefert afplay, afconvert und afinfo für Wiedergabe, Konvertierung und Analyse mit, aber kein afrecord. Für reine Audioaufnahmen aus dem Terminal installierst du ffmpeg oder SoX über Homebrew.

Quellen

Hannes Hennerbichler entwickelt AirCheck und nimmt damit seine eigenen DJ-Sets über ein Focusrite Scarlett 8i6 auf. Jeder Schritt auf dieser Seite wurde auf der oben genannten macOS-Version ausgeführt. Mit KI-Unterstützung entworfen, vom Autor geprüft und überarbeitet. Über