Deutsch

So richtest du einen Controller in Ryujinx am Mac ein

InputConfig im Mac App Store ladenDiese App ist komplett kostenlos. Du musst kein Konto anlegen. Es gibt keine Abos, keine umständlichen Downloads, und nichts ist gesperrt. Optimiert für Apple Silicon.

Öffne in Ryujinx Options, Settings, klicke auf Input, wähle Player 1 und suche deinen Controller im Menü Input Device aus. Stelle Controller Type auf Pro Controller, prüfe, dass jedes Tastenfeld die gewünschte Taste zeigt, und klicke auf Save. Ein PS5-, PS4-, Xbox-, Switch-Pro- oder 8BitDo-Controller, den der Mac schon unter Spielecontroller aufführt, erscheint normalerweise ohne weitere Installation in diesem Menü, und die meisten toten Controller werden in diesem einen Fenster behoben.

Ich entwickle InputConfig, eine kostenlose Mac-App, die Controller auf Tasten und die Maus legt. Ryujinx liest Controller selbst, braucht für das Pad also keinen Mapper. Ich bringe InputConfig nur dort ins Spiel, wo es wirklich hilft: bei den Hotkeys, die Ryujinx auf der Tastatur hält, und bei einem Pad, das Ryujinx nicht auflisten kann.

Version 1.7 von InputConfig, voraussichtlich im Oktober 2026, bringt vollständige Unterstützung für Deutsch.

Schritte

  1. Verbinde den Controller mit dem Mac und prüfe, dass er in den Systemeinstellungen unter Spielecontroller aufleuchtet.
  2. Öffne in Ryujinx Options, Settings und klicke auf Input.
  3. Wähle Player 1 und suche dann deinen Controller im Menü Input Device aus.
  4. Stelle Controller Type auf Pro Controller, prüfe jedes Tastenfeld und klicke auf Save.
  5. Zeigt ein Spiel das Controller Applet, gleiche die aufgelisteten Spieler und Controllertypen ab und starte das Spiel dann neu.

Prüfen, welches Ryujinx du nutzt

Das ursprüngliche Ryujinx-Projekt wurde im Oktober 2024 eingestellt. Der Name lebt in einem Fork der Community weiter, und das ist der Build, den man 2026 nutzt. Am 22. Oktober 2026 habe ich seine Seite ryujinx.app gelesen, die ihn einen Nintendo-Switch-1-Emulator nennt, sagt, er sei Open Source unter der MIT-Lizenz auf einem eigenen Forgejo-Server, und sagt, er sei an rund 4.300 Titeln getestet. Ihre Downloadseite sagt, nur Macs mit Apple Silicon würden richtig unterstützt. Sein Forgejo-Server und sein Blog luden an diesem Tag bei mir nicht, ich kann also keine Versionsnummer nennen.

  • Ein alter Build von 2024. Korrekturen an der Eingabe seitdem gibt es nur im Fork, aktualisiere also, bevor du einem Controller-Problem nachjagst.
  • Ein Intel-Mac. Die Downloadseite verspricht nicht, dass er gut funktioniert, und das ist gut zu wissen, bevor du dem Pad die Schuld gibst.
  • Download-Seiten, die ähnlich aussehen. Viele Seiten übernehmen den Namen. Lade ihn von der eigenen Seite des Projekts.

Beginne mit einem aktuellen Build des Forks von seiner eigenen Seite, bevor du eine einzige Eingabeeinstellung änderst. Diese Seite behandelt nur Controller, keine Spieldateien oder Schlüssel.

Player 1 in den Input-Einstellungen von Ryujinx einrichten

  • Du: Verbinde das Pad, öffne Options, Settings, Input, wähle oben Player 1 und suche das Pad unter Input Device aus. Stelle Controller Type auf Pro Controller.
  • Ryujinx: Füllt die Felder für Tasten, Sticks und Trigger für dieses Pad.
  • Prüfen: Klicke ein Feld an, etwa A, und drücke die Taste, die du dafür willst. Das Feld zeigt, was es gehört hat. Klicke auf Save.

Dasselbe Fenster hält die Einstellungen, die viele übersehen:

  • Refresh input devices. Diese Schaltfläche listet ein Pad auf, das du nach dem Öffnen von Ryujinx verbunden hast.
  • Profile. Benenne ein Layout mit Add, sichere es und lade es später mit Load, damit ein zweites Pad oder eine Neuinstallation kurz geht. Das Profil Default lässt sich nicht überschreiben.
  • Docked Mode. Eingeschaltet verhält sich Ryujinx wie eine angedockte Switch. Ausgeschaltet verhält es sich wie ein Handheld, und das Spiel erwartet dann den Spieler Handheld.
  • Global Input. In den eigenen Einstellungen eines Spiels lässt es dieses Spiel das globale Layout statt seines eigenen nutzen.
  • Reset keybinds to default. Setzt jedes Feld für das gewählte Gerät zurück.
  • Motion und Rumble. Motion hat Use CemuHook Compatible Motion und die Gyro-Empfindlichkeit. Rumble hat Multiplikatoren für stark und schwach sowie Enable HD Rumble, was Ryujinx als experimentell und nur für Nintendo-Controller des Herstellers kennzeichnet.

Input Device ist die Einstellung, die die meisten toten Controller behebt, denn sie steht oft noch auf Keyboard oder Disabled.

Das Controller Applet lesen, wenn ein Spiel es zeigt

Manche Spiele fragen beim Start nach Controllern, und Ryujinx antwortet mit einem Fenster namens Controller Applet. Es listet Players und Supported Controllers auf, sagt, deine aktuelle Konfiguration sei ungültig und du solltest die Einstellungen öffnen und deine Eingaben neu konfigurieren, mit einer Schaltfläche Open Settings Window. Es bedeutet, dass das Spiel ein Setup möchte, das deine Einstellungen ihm nicht geben.

  • Den Controllertyp abgleichen. Enthält die Liste Pro Controller nicht, wähle in Controller Type für Player 1 einen der aufgelisteten Typen, etwa JoyCon Pair.
  • Die Spielerzahl abgleichen. Ein Spiel, das zwei Spieler verlangt, braucht auch für Player 2 ein Gerät.
  • Angedockt und Handheld abgleichen. Sagt das Applet, der angedockte Modus sei gesetzt und die Handheld-Steuerung solle deaktiviert sein, lass Handheld auf Disabled und nutze Player 1.

Unter System, Hacks gibt es Ignore Controller Applet, das verhindert, dass das Fenster erscheint, wenn sich ein Pad mitten im Spiel trennt. Ryujinx' eigener Tipp sagt, es im Zweifel auszulassen, und das würde ich auch tun. Das Applet sagt dir genau, was das Spiel verlangt, lies also seine zwei Listen, bevor du sonst etwas änderst.

Wenn der Controller weiterhin nichts tut

Steige diese Leiter hinauf, kleinster Schritt zuerst:

  1. Den Mac prüfen. Die Systemeinstellungen, Spielecontroller sollten das Pad auflisten und jede Taste aufleuchten lassen. Tun sie es nicht, liegt das Problem bei der Kopplung, und Controller wird am Mac nicht erkannt beginnt dort.
  2. Die Geräteliste aktualisieren. Drücke Refresh input devices oder beende Ryujinx und öffne es mit schon verbundenem Pad neu.
  3. Das Pad wählen, nicht die Tastatur. Input Device für Player 1 muss deinen Controller nennen.
  4. Sichern, dann das Spiel neu starten. Ein Spiel, das das Controller Applet zeigte, fragt beim Start erneut nach Controllern.
  5. Den Fokusverlust prüfen. On Emulator Focus Loss in den Einstellungen unter Interface kann Eingaben blockieren, wenn ein anderes Fenster vorn ist. Klicke auf das Spielfenster.
  6. Steam beenden. Steam Input kann das Pad in eigene Tasten verwandeln, sodass Drücke doppelt oder am falschen Ort ankommen.
  7. Vertauschte oder tote Tasten. Klicke das Feld unter Input an und drücke die gewünschte Taste. Das Feld nimmt, was das Pad sendet, was auch immer darauf aufgedruckt ist.

Ein Pad, das in den Spielecontrollern und im Fenster Input funktioniert, aber nicht im Spiel, ist fast immer ein Fall für das Controller Applet oder die Spielereinstellung. Emulator-Controller funktioniert am Mac nicht behandelt dieselben Prüfungen für andere Emulatoren.

Wissen, welche Controller er am Mac liest

Der Quelltext von Ryujinx liest Controller über SDL3, es sieht also die Pads, die der Mac sieht. Ich habe nicht jedes Pad unten selbst in Ryujinx getestet. Entscheidend ist, wie jedes beim Mac ankommt:

  • PS5- und PS4-Controller. Sie koppeln über Bluetooth in den Systemeinstellungen. Siehe einen PS5-Controller verbinden.
  • Xbox Wireless Controller. Sie koppeln über Bluetooth. Ein Xbox-360-Pad mit Kabel wird von macOS gar nicht unterstützt.
  • Der Switch Pro Controller. Er koppelt über Bluetooth und ist der Controller, den Switch-Spiele erwarten, Pro Controller in Ryujinx passt also am besten.
  • Joy-Cons. macOS koppelt jeden einzeln. Ryujinx hat die Typen JoyCon Pair, JoyCon Left und JoyCon Right, aber ich habe nicht geprüft, wie es zwei am Mac gekoppelte Joy-Cons zu einem Paar verbindet.
  • 8BitDo-Pads. Nur in dem Modus, den 8BitDo für Apple-Geräte nennt, bei den meisten Modellen D. 8BitDo-Controller am Mac hat jedes Modell.

Listet der Mac ein Pad unter Spielecontroller, lohnt es sich, es im Menü Input Device von Ryujinx zu wählen.

Die Hotkeys von Ryujinx auf freie Tasten legen

Ryujinx hält seine Hotkeys auf der Tastatur, unter Settings, Hotkeys. Standardmäßig schaltet F1 VSync um, F2 stummschaltet, F4 zeigt oder verbirgt die Oberfläche, F5 pausiert und F8 macht einen Screenshot. Turbo Mode, Lautstärke und Auflösungsskalierung beginnen ungebunden, gib ihnen dort also zuerst eine Taste. InputConfig kann diese Tasten von Tasten aus drücken, die Ryujinx ungebunden lässt, etwa der Taste Create oder Share, dem Klick des DualSense-Touchpads oder einem Paddle des DualSense Edge.

  • Du: Lege ein Preset für Ryujinx an, füge eine Zeile hinzu, drücke Scannen (Scan) und drücke die freie Taste. Setze die Ausgabe auf Keyboard Key und wähle F5.
  • InputConfig: Sendet F5 bei jedem Druck auf diese Taste, neben dem Pad, das Ryujinx liest.
  • Prüfen: Drücke die Taste in einem Spiel. Das Spiel pausiert. Ich habe Ryujinx nicht selbst mit Tasten getestet, die InputConfig sendet, prüfe also eine Taste, bevor du mehr baust.
Der Editor von InputConfig mit Zeilen, die die Pfeiltasten, Control, Option, Leertaste und Escape von Controller-Tasten senden.
Figure 1. Jede Zeile sendet eine Taste von einer Taste. Für Ryujinx würdest du Zeilen wie diese mit F4, F5 und F8 auf Tasten nehmen, die der Emulator ungebunden lässt.

Nenne Ryujinx unter Activate when these apps are in front, dann schaltet sich das Preset nur ein, solange Ryujinx vorn ist. Belege nur Tasten, die Ryujinx nicht nutzt, sonst tut jeder Druck zwei Dinge zugleich.

Der Bereich Automation and Gaming Utilities eines Presets in InputConfig, mit einer App unter Activate when these apps are in front aufgelistet.
Figure 2. Die App-Liste eines Presets. Füge Ryujinx hier hinzu, und die Hotkey-Tasten funktionieren nur, solange es vorn ist.

Ein Tastaturprofil von einem Pad aus steuern, das Ryujinx nicht auflisten kann

Einige Pads erscheinen nie im Menü Input Device, oft einfache USB-Pads, die macOS nicht als Game-Controller behandelt. Leuchtet der Live Visualizer von InputConfig die Tasten des Pads auf, kann InputConfig es in die Tastaturtasten verwandeln, die Ryujinx für Player 1 mit gewählter Keyboard schon nutzt:

Switch-BedienelementStandardtaste in RyujinxLege es auf
Linker StickW, A, S, D und F zum KlickenDen linken Stick des Pads
SteuerkreuzDie PfeiltastenDas Steuerkreuz
A, B, X, YZ, X, C, VDie rechte, untere, obere und linke Aktionstaste, die Positionen der Switch
L, R, ZL, ZRE, U, Q, ODie Schultertasten und Trigger
Rechter StickI, J, K, L und H zum KlickenDen rechten Stick

Auch Minus und Plus haben Standardwerte: Prüfe, welche Tasten das Fenster Input von Ryujinx dafür zeigt, und belege diese. Teste es dann auf die schnelle Art: Klicke mit Keyboard als Input Device ein Feld an und drücke die Pad-Taste. Füllt sich das Feld mit der Taste, bekommt Ryujinx die Tasten von InputConfig. Ein als Tasten gesendeter Stick ist entweder ganz gedrückt oder gar nicht, das ist also ein Notbehelf für Pads, die Ryujinx nicht sehen kann, nie ein Ersatz für eines, das es sehen kann.

Was es nicht kann

  • Kein virtueller Controller. InputConfig sendet Tasten und Mausereignisse. Es kann ein Pad für Ryujinx nicht wie ein anderes Gamepad aussehen lassen.
  • Kein Analog über Tasten. Der Weg über die Tastatur verliert halbe Neigungen der Sticks und Trigger.
  • Kein Gyro oder Rumble darüber. Bewegung und Rumble funktionieren nur über die eigene Controller-Unterstützung von Ryujinx.

Ich würde Ryujinx das Pad lesen lassen und InputConfig für die Tasten drumherum behalten.

Die Kurzfassung

  • Einrichten. Gehe zu Options, Settings, Input, wähle Player 1, suche das Pad unter Input Device aus, wähle Pro Controller und klicke auf Save.
  • Das Applet lesen. Gleiche die Spieler und Controllertypen ab, die das Controller Applet auflistet.
  • Die Hotkeys ergänzen. Ein InputConfig-Preset legt F4, F5 und F8 auf Tasten, die Ryujinx frei lässt.

Leuchtet der Mac das Pad in den Spielecontrollern auf, liegt die Lösung fast immer im Fenster Input von Ryujinx.

Fragen

Warum funktioniert mein Controller in Ryujinx am Mac nicht?

Meist steht Input Device für Player 1 noch auf Keyboard oder Disabled, oder das Pad wurde nach dem Öffnen von Ryujinx verbunden. Drücke Refresh input devices, wähle das Pad, stelle Controller Type auf Pro Controller und klicke auf Save.

Was ist das Controller Applet in Ryujinx?

Ein Fenster, das manche Spiele öffnen, um nach Controllern zu fragen. Es listet die Spieler und Controllertypen auf, die das Spiel unterstützt. Gleiche sie unter Settings, Input ab und starte das Spiel dann neu.

Funktioniert ein PS5-Controller mit Ryujinx am Mac?

Ryujinx liest Controller über SDL3, das einen in den Systemeinstellungen unter Bluetooth gekoppelten DualSense liest. Wähle ihn im Menü Input Device für Player 1 und prüfe die Tastenfelder.

Was sind die Standard-Tastaturbelegungen von Ryujinx?

W, A, S und D für den linken Stick, die Pfeiltasten für das Steuerkreuz, Z, X, C und V für A, B, X und Y sowie E, U, Q und O für L, R, ZL und ZR. Der rechte Stick ist I, J, K und L.

Wird Ryujinx 2026 noch weiterentwickelt?

Das ursprüngliche Projekt wurde 2024 eingestellt. Ein Fork der Community läuft auf ryujinx.app weiter, der sich am 22. Oktober 2026 als Open Source unter der MIT-Lizenz beschrieb und nur auf Macs mit Apple Silicon richtig unterstützt.

Mehr auf Deutsch

Ausführliche Anleitungen, auf Englisch

Wer hier schreibt. Ryleigh Newman entwickelt InputConfig und steuert den eigenen Mac jeden Tag mit einem Controller, weil die Hände nicht gut mitmachen. Diese Seite ist aus dem Englischen übersetzt. Die wichtigsten Tasten und Menüs der App erscheinen auf Deutsch, wenn der Mac auf Deutsch eingestellt ist; diese Seite nennt sie so, mit dem englischen Namen in Klammern. Der Rest der App und der Website ist auf Englisch.

Diese Seite in anderen Sprachen: English, العربية, Čeština, Dansk, Español, Suomi, Français, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文, 简体中文

InputConfig im Mac App Store ladenKostenlos. macOS 14 oder neuer. Kein Konto, nichts verlässt deinen Mac. Open Source auf GitHub.