Es gibt eine Methode.
Das Projekt hat ein Backend, um das aktive Fenster zu erkennen. Dennoch kann ein Paket oder eine Begleiterweiterung nötig sein.
PRAXISGUIDE / KOMPATIBILITÄT
Wird deine Linux-Sitzung
erkannt?
Diese Seite hilft dir zu prüfen, ob geetRPCS-linux das Fenster oder Spiel erkennen kann, das du verwendest. Wähle deine Umgebung, lies ihren Status und folge den gegebenenfalls nötigen Installationshinweisen.
BEVOR DU WEITERLEST
Was diese Seite
wirklich prüft.
Die folgenden Status betreffen die Erkennung des aktiven Fensters: wie geetRPCS-linux weiß, welches Spiel oder Programm im Vordergrund steht. Allein aus ihnen folgt nicht, dass Discord verbunden ist, noch dass das Symbol der Software in deinem Panel erscheint.
Damit alles funktioniert, brauchst du außerdem einen Discord-Client mit Rich-Presence-Unterstützung und – wenn du das Tray-Symbol möchtest – ein StatusNotifierItem-kompatibles Panel.
SCHNELLTEST · 5 FRAGEN
Ist mein Desktop
kompatibel?
Antworte entsprechend deiner Konfiguration: Der Fragebogen zeigt, ob die Erkennung unterstützt wird, was zu installieren ist und welche Probleme einzuplanen sind. Er funktioniert ohne JavaScript und sammelt nichts.
DEIN ERSTER SCHRITT
Welche Sitzung nutzt du?
Der Name deines Desktops reicht nicht immer aus: GNOME, KDE Plasma oder ein Fenstermanager kann mit Wayland oder X11 laufen.
WaylandGNOME, KDE, Sway, Hyprland …
X11 / XorgXFCE, Cinnamon, i3, GNOME Xorg …
Andere / Ich weiß es nichtManuelle Methoden und ungeprüfte Fälle ansehen.
Wie finde ich meine Sitzung heraus?
Öffne ein Terminal und führe aus:
echo "$XDG_SESSION_TYPE"Der Befehl zeigt üblicherweise wayland oder x11. Du kannst die Sitzungsinformationen auch in den Systemeinstellungen oder auf dem Anmeldebildschirm deiner Distribution nachsehen.
STATUS VERSTEHEN
Drei Stufen.
Kein falsches „Ja“.
Ein Status gibt an, wie gut die Erkennung unterstützt wird – gemäß der Dokumentation und den Mechanismen, die in Version v0.4.3 vorhanden sind.
Ein Eingriff ist nötig.
Die Erkennung beruht auf einer speziellen Konfiguration oder einem Fallback-Mechanismus. Je nach Anwendungen kann sie unvollständig sein.
Zu wenig Informationen.
Die Umgebung ist in der Matrix nicht dokumentiert. Das heißt nicht, dass sie inkompatibel ist.
Nicht unterstützt: Diese Kennzeichnung ist Umgebungen vorbehalten, die ausdrücklich als inkompatibel erklärt werden. Keine konkrete Umgebung ist in der mitgelieferten Dokumentation zu v0.4.3 so markiert.
01 — WAYLAND
Unterstützt.
Wayland ist das Anzeigesystem vieler aktueller Linux-Sitzungen. Das Projekt stützt sich nicht auf eine einzige Methode: Manche Desktops brauchen ihren eigenen Begleiter.
WAYLAND · WLROOTS Unterstützt
Wayfire, Sway,
Hyprland und labwc
Die Erkennung nutzt ein Protokoll, das diese Compositors gemeinsam haben. Die Software kann die Informationen des aktiven Fensters abrufen, ohne eine Erweiterung speziell für jeden Desktop.
Was du prüfen musst
Bei Wayfire muss das Plugin foreign-toplevel aktiviert sein. Sway, Hyprland und labwc nutzen das entsprechende Backend, wenn es verfügbar ist.
Technische Details zu Wayfire
Füge in ~/.config/wayfire.ini foreign-toplevel zur bestehenden Plugin-Liste im Abschnitt [core] hinzu und starte Wayfire neu. Ersetze deine komplette Plugin-Liste nicht durch ein Minimalbeispiel.
WAYLAND · GNOME / MUTTER Unterstützt
GNOME
Wayland
GNOME setzt Mutter ein, das das wlroots-Protokoll nicht bereitstellt. geetRPCS-linux stützt sich deshalb auf eine kleine GNOME-Shell-Erweiterung, die das aktive Fenster meldet.
Was du prüfen musst
Die Erweiterung geetRPCS Window Tracker muss installiert und aktiviert sein. Version v0.4.3 nennt GNOME Shell 45 bis 51. Das Hauptinstallationsprogramm versucht, sie automatisch zu installieren, wenn die nötigen GNOME-Werkzeuge verfügbar sind.
Warum ist eine Erweiterung nötig?
Nicht alle Wayland-Desktops gewähren Zugriff auf dieselben Fensterinformationen. Der GNOME-Begleiter übergibt lokal Kennung und Titel des fokussierten Fensters an den Prozess geetRPCS-linux.
WAYLAND · KDE / KWIN Unterstützt
KDE Plasma
5.27 bis 6.x
Unter Plasma Wayland meldet ein KWin-Begleiterskript das fokussierte Fenster über eine lokale D-Bus-Brücke an die Software.
Was du prüfen musst
Das Skript geetrpcsWindowTracker muss hinterlegt sein. Das Installationsprogramm richtet es automatisch ein, wenn es aus einer kompatiblen KDE-Sitzung gestartet wird.
Warum ein KWin-Begleiter?
KWin liefert nicht das wlroots-Protokoll, das Sway oder Hyprland nutzen. Das Begleiterskript übermittelt die Fensterinformationen deshalb über den im Projekt vorgesehenen Mechanismus an geetRPCS-linux.
02 — X11 / XORG
Die X11-Sitzungen.
X11 (oft Xorg genannt) ist ein weiteres Anzeigesystem, das von mehreren Linux-Umgebungen und Fenstermanagern noch verwendet wird.
X11 · XORG Unterstützt
GNOME Xorg, XFCE, Cinnamon, i3 und andere kompatible X11-Sitzungen
Die Software fragt mit xprop bei X11 nach, welches Fenster aktiv ist, und ruft dann seine Kennung und Informationen ab.
Was du prüfen musst
Das Paket, das xprop liefert, muss installiert sein. Unter Arch Linux ist das xorg-xprop; auf vielen Debian/Ubuntu-Distributionen kommt es mit x11-utils.
Wozu dient xprop?
xprop ist ein kleines Kommandozeilen-Tool zum Auslesen der Eigenschaften von X11-Fenstern. geetRPCS-linux nutzt es, um das aktive Fenster zu identifizieren; eine Desktop-Erweiterung ist es nicht.
03 — WAYLAND: SONDERFÄLLE
Teilweise oder
manuelle Konfiguration.
Diese Umgebungen haben keine so direkte Integration. Die Erkennung erfordert ein externes Tool oder beschränkt sich auf Fenster, die über X11/XWayland zugänglich sind.
WAYLAND · GENERISCHES BACKEND Manuell
Weston, Enlightenment
und andere Compositors
Eine temporäre Statusdatei kann geetRPCS-linux Kennung und Titel des aktiven Fensters liefern. Die Software holt sie sich nicht selbst: Ein externes Tool muss diese Informationen erzeugen.
Für wen?
Diese Methode richtet sich an fortgeschrittene Nutzer, die ihr eigenes Tool zur Fensterbeobachtung einrichten können.
Erwartetes Format ansehen (fortgeschrittene Nutzer)
Zu aktualisieren ist die Datei $XDG_RUNTIME_DIR/geetrpcs-linux/active-window.json. Sie muss die Felder app_id, title und updated_at (Unix-Zeitstempel in Sekunden) enthalten. Die Datei muss aktualisiert werden, bevor ihr Inhalt abläuft, also alle 6 Sekunden.
{
"app_id": "org.example.Application",
"title": "Fenstertitel",
"updated_at": 1794067200
}Der Wert updated_at oben ist ein Formatbeispiel: Dein Tool muss bei jeder Aktualisierung die aktuelle Zeit erzeugen.
WAYLAND · X11-/XWAYLAND-FALLBACK Eingeschränkt
COSMIC und Sitzungen
ohne dediziertes Backend
Fehlt ein natives Backend, kann geetRPCS-linux seinen X11-/XWayland-Fallback nutzen. Das erlaubt nicht, alle nativen Wayland-Fenster zu verfolgen.
Was das bedeutet
Anwendungen, die über X11 oder XWayland zugänglich sind, lassen sich erkennen. Für native Wayland-Fenster gilt diese Zusicherung nicht.
04 — BENACHRICHTIGUNGSSYMBOL
Erkennung und Tray-Symbol
sind zwei verschiedene Dinge.
Die Erkennung teilt der Software mit, welches Fenster aktiv ist. Der Tray (das kleine Symbol neben der Uhr) hängt vom Panel deines Desktops ab. geetRPCS-linux verwendet das Protokoll StatusNotifierItem: Das Panel muss daher einen kompatiblen Host besitzen, um das Symbol anzuzeigen.
Unter GNOME Shell kann ein AppIndicator-/StatusNotifierItem-kompatibler Host oder eine Erweiterung nötig sein. Budgie Panel und die Wayfire-Panels brauchen ebenfalls ein passendes StatusNotifier-Applet.
Ist kein Tray-Host verfügbar, bleibt die GTK-Oberfläche nutzbar; die Software sieht einen Notfallmodus mit ihrem Hauptfenster vor.
05 — DISCORD-CLIENT
Prüfe auch
deinen Discord-Client.
Auch wenn das Fenster korrekt erkannt wird, kann die Präsenz nur erscheinen, wenn geetRPCS-linux einen kompatiblen Discord-Client erreicht und eine nutzbare Application ID für Discord vorliegt.
Discord Desktop
Der Linux-Client nutzt seinen lokalen IPC-Socket. Starte Discord, bevor du den Verbindungsstatus prüfst.
Natives Vesktop
Öffne die Vesktop-Einstellungen und aktiviere Enable Rich Presence via arRPC. Vesktop bringt den arRPC-Server bereits mit.
Vesktop Flatpak
Die Sandbox kann den Zugriff auf den Host-Socket blockieren. Die native Installation wird empfohlen; konsultiere die Vesktop-Dokumentation, wenn du Flatpak behältst.
06 — NICHT ERFASSTE UMGEBUNGEN
UngeprüftDeine Umgebung taucht nicht auf?
Das ist nicht zwangsläufig ein Problem. Es bedeutet nur, dass die Unterstützung in der für diese Seite verwendeten Dokumentation zu v0.4.3 nicht beschrieben ist. Der Desktop kann dank eines der vorhandenen Mechanismen funktionieren, doch ohne Ausprobieren gilt das nicht als bestätigt.
Keine konkrete Umgebung wird in dieser Dokumentation ausdrücklich als „nicht unterstützt“ erklärt. Die Matrix unterscheidet bewusst zwischen „ungeprüft“ und „inkompatibel“.
07 — KLEINES GLOSSAR
Die Begriffe
einfach erklärt.
Einige Fachbegriffe tauchen in den Einträgen auf. Hier ist, was sie bedeuten – ohne in die Implementierungsdetails einzutauchen.
Wayland
Ein modernes Anzeigesystem, das von vielen Linux-Desktops genutzt wird. Es schützt die Informationen zwischen Anwendungen stärker; die Erkennungsmethoden unterscheiden sich daher je nach Desktop.
X11 / Xorg
Ein älteres Anzeigesystem, das noch weit verbreitet ist. Es bietet eine Methode zum Auslesen des aktiven Fensters, die geetRPCS-linux nutzt.
Backend
Die technische Methode, mit der die Software den Namen oder die Kennung des aktiven Fensters in einer bestimmten Sitzung erhält.
Erweiterung / Begleiter
Ein kleines Modul, das zum Desktop hinzugefügt wird (etwa GNOME Shell oder KWin), um der Software eine Information zu übermitteln, die das Anzeigesystem nicht direkt liefert.
XWayland
Eine Kompatibilitätsschicht, die es manchen für X11 gebauten Anwendungen erlaubt, in einer Wayland-Sitzung zu laufen.
StatusNotifierItem (tray)
Ein Protokoll, mit dem eine Anwendung ihr Symbol und ihr Menü im Benachrichtigungsfeld eines kompatiblen Linux-Panels anzeigen kann.
DOKUMENTATIONSBASIS: v0.4.3
Ist deine Umgebung
in der Liste?
Kehre zur Projektvorstellung zurück, um ihre Funktionen, Voraussetzungen und aktuellen Grenzen zu verstehen.