Apps & Installation

Vor der Installation offizieller Pakete zeigt dir das Terminal an, dass es nach ausstehenden Systemaktualisierungen sucht. Diese Prüfung kann etwas dauern, bevor du nach deinem Administratorpasswort gefragt wirst. Auch Flatpak-Installationen zeigen ihre Vorbereitungsphase an. Stehen Aktualisierungen aus, erklärt es den Grund: Arch installiert Apps nur auf einem aktuellen System, und eine Installation jetzt würde auch einen Teil des Systems ohne Wiederherstellungs-Snapshot aktualisieren. Enter führt die Systemaktualisierung mit Snapshot aus und installiert danach; Esc bricht ab, ohne etwas zu ändern.

SUPER + Space und Hauptmenü > Apps öffnen dieselbe Anwendungsliste. Enter startet eine App. Delete bietet in Apps eine bestätigte Deinstallation an. Die globale Suche über SUPER + F startet Apps, bietet aber keine Deinstallation. Es gibt kein separates Menü mit angehefteten Apps.

Eingaben im Hauptmenü suchen installierte Apps und Aktionen aus allen Untermenüs. In einem Untermenü wie System oder Installieren umfasst die Suche dieses und alle darunterliegenden Menüs. Tastaturlayouts und alles unterhalb eines Cloud-Kontos (Dienste, Ressourcen, Logs) werden nur in ihrem eigenen Menü durchsucht; die Cloud-Kontolisten bleiben in der Suche. Untermenüzeilen enden mit >; Shift + Backspace führt zum übergeordneten Menü.

Dynamische Menüs durchsuchen auch bereits geladene untergeordnete Aktionen, etwa die eines installierten Plugins oder eines Git-Kontos. Die Suche verwendet die geladenen Daten erneut; öffne die Ressourcenauswahl oder Visuals, um Optionen zu suchen, die einen weiteren Anbieterabruf benötigen.

Installieren

Drücke Delete bei einem installierten Eintrag in den Anwendungs- und Werkzeuglisten unter Installieren, um ihn nach einer Bestätigung zu deinstallieren. Web-Apps behalten ihre Aktion zum Entfernen. In den Paketlisten (Pacman und Yay) entfernt Ctrl+D das markierte installierte Paket nach Bestätigung. Ctrl+F wechselt zwischen installierten und allen Paketen. Eitr-Pakete bleiben installiert. Erforderliche Systemabhängigkeiten werden nie rekursiv entfernt. pacman verweigert das Entfernen, wenn dadurch ein anderes Paket beschädigt würde.

Bei verwalteten Sprachpaketen siehst du zunächst die vollständige Warnung im Terminal. Danach bestätigst du mit [y/N]; Enter bricht ab. Bei Node werden alle von NVM verwalteten Versionen und ihre globalen npm-Werkzeuge entfernt. Bei Python betrifft dies die von uv verwalteten Versionen und uv selbst, nicht System-Python. Bei Java werden die aktuellen SDKMAN-Versionen von Java und Maven entfernt, bei Rust nur die stabile Toolchain. Rails und Laravel entfernen ihre Framework-Werkzeuge; Ruby, PHP und Composer bleiben erhalten. Projekte, Einstellungen und Zugangsdaten bleiben erhalten, aber abhängige Werkzeuge und Umgebungen funktionieren danach möglicherweise nicht mehr. Beim Entfernen nativer Assistenten bleiben zwischengespeicherte Versionen und Einstellungen erhalten.

Vorhandene Apps zeigen Installiert unter ihrem Namen; die Auswahl meldet dies, statt erneut zu installieren. Auch über eigene Manager installierte Werkzeuge werden erkannt, etwa Java aus SDKMAN oder Node.js aus NVM. Pakete mit Laufzeitbedarf, beispielsweise DBeavers Java, bringen eine kleine Laufzeit nur mit, wenn noch kein Paket sie bereitstellt.

• KI-CLIs: optionale KI-Kommandozeilenprogramme.
• Browser: unterstützte Browserauswahl.
• Datenbanken: optionale Werkzeuge wie DBeaver, Datenbankclients und Valkey, der Redis-kompatible Server, den Arch statt Redis ausliefert.
• Entwicklungssprachen: optionale Entwicklungswerkzeuge; Java/Flutter sind keine erforderlichen Desktop-Abhängigkeiten.
• JavaScript-Werkzeuge: optionale JavaScript-Laufzeiten und Werkzeuge.
• Pakete > Pacman und Pakete > Yay (AUR): offizielle Arch-Pakete oder Community-AUR-Pakete suchen, jeweils mit Herkunft und Installationsstatus. Oben steht die Suche, darunter die Pakete und unten die Auswahldetails. Ctrl+B wechselt zur Bauanweisung (PKGBUILD) und zurück, Ctrl+O öffnet die Webseite, Tab wählt mehrere Pakete und Enter installiert sie. AUR-Pakete werden auf diesem Rechner nach ihrer Bauanweisung erstellt: Lies diese zuerst. Es sind keine offiziellen Arch-Pakete.

Installations-, Aktualisierungs- und Einrichtungsterminals zeigen das EITR-Banner im aktuellen Design. Erfolgreiche Aufgaben schließen normalerweise; Fehler bleiben sichtbar. Berichte wie Bereinigung bleiben zum Lesen offen. Normale Terminals und Über zeigen kein Aufgabenbanner.

Drücke Esc, um wartende Aufgaben-, Konto-, Berichts- und Über-Terminals zu schließen. Enter bleibt für Antworten und Bestätigungen vorgesehen, etwa zum Bestätigen der notierten Wiederherstellungsschlüssel und zum Ausschalten im Installationsprogramm.

eitr package install NAME installiert ein offizielles Paket, eitr package install --aur NAME ein AUR-Paket und eitr package remove NAME entfernt ein Paket. Ein Terminal ist erforderlich. Die Übersicht zeigt Paket und Quelle: Enter bestätigt, Esc bricht ab. Bei AUR zeigt Ctrl+B die Bauanweisungen (q kehrt zurück); Ctrl+O öffnet das Build-Repository. AUR-Pakete stammen aus der Community und werden weder von Eitr noch Arch Linux geprüft. Bereits installierte Pakete beenden den Vorgang erfolgreich. Fehler bleiben bis Esc sichtbar. Plugins können kitty --class eitr-menu-terminal -e eitr package install --aur lowfi verwenden.

Werkzeuge

Rechner in Apps oder die Rechnertaste öffnet Eitrs Rechner in den Designfarben. Tippe oder klicke: + − × ÷, ^ für Potenzen, % für Prozent (200×15%), √ und Klammern. Eine Zahl vor einer Klammer multipliziert (2(3+4)). Enter zeigt das Ergebnis, Backspace entfernt ein Zeichen, Escape leert (zweimal schließt), Ctrl+C oder Kopieren kopiert das Ergebnis. Ausdrücke werden berechnet, nicht als Code ausgeführt.

Offline-Diktat wandelt Sprache in Text um, ohne den Rechner zu verlassen. Halte SUPER + D, sprich und lass los: Der Text wird an der Cursorposition in der gesprochenen Sprache eingefügt. Du kannst SUPER + D auch kurz drücken, sprechen und erneut drücken. Beim Zuhören wird der rote Punkt links neben der Uhr zur kleinen Wellenform, die deiner Stimme folgt und die Erfassung sichtbar macht; nach dem Loslassen pulsiert sie bis zur Texteingabe. Beim ersten Einsatz wird einmalig das Sprachmodell heruntergeladen (148 MB, mit veröffentlichter Prüfsumme geprüft), nach ~/.local/share/eitr/whisper/; danach funktioniert es offline. Die Transkription dauert nach dem Loslassen kurz, auf älteren Prozessoren länger. Die Aufnahme endet beim Loslassen von D, auch wenn SUPER zuerst losgelassen wurde, oder nach 120 Sekunden; anschließend wird der Text wie gewohnt transkribiert.

Hauptmenü > Werkzeuge > Erinnerungen > Neue Erinnerung fragt nach Zeitpunkt (Dauer wie 10m oder 1h30m, Uhrzeit wie 18:30) und Inhalt. Dann erscheint eine Benachrichtigung mit Schaltflächen zum Schlummern und Schließen. Kommende Erinnerungen listet wartende Einträge; wähle einen zum Abbrechen. Sie überstehen Neustarts; bei ausgeschaltetem Rechner fällige Erinnerungen erscheinen bei der nächsten Anmeldung. Im Terminal: eitr remind 25m Take the tea out; eitr remind allein listet sie auf.

Spielen

Hauptmenü > Spielen listet GeForce NOW, RetroArch und Steam. Die Auswahl öffnet installierte Programme und installiert fehlende. RetroArch stammt aus offiziellen Arch-Paketen mit Kernen für NES, SNES, Game Boy und Game Boy Advance, Mega Drive/Genesis, PlayStation, Nintendo 64, Nintendo DS, PSP und Dreamcast. Füge eigene Spiele und nötige BIOS-Dateien hinzu; Eitr liefert beides nicht mit. GeForce NOW wird per Flatpak installiert.

Schnellaktionen > Spielmodus reduziert Desktop-Störungen: Fensteranimationen, Unschärfe und Schatten aus, Benachrichtigungs-Popups aufgeschoben (Nicht stören), Leistungsprofil an, sofern vorhanden. Ausschalten stellt genau seine Änderungen zurück. Steam kommt mit GameMode und MangoHud: Füge gamemoderun mangohud %command% den Steam-Startoptionen eines Spiels hinzu, um die CPU beim Spielen zu optimieren und die FPS-Anzeige einzublenden.

LocalSends Paket enthält seine Laufzeitvoraussetzungen; zum Ausführen ist kein Flutter SDK nötig. Entwicklungswerkzeuge bleiben optional.

Für Aktualisierungen siehe Updates und Bereinigung; ein einzelnes Paket zu installieren ist nicht dasselbe wie die Snapshot-geschützte Systemaktualisierung.

Musikvisualisierer öffnet cava in den Theme-Farben. Ein Rechtsklick auf den Medien-Equalizer öffnet denselben Visualisierer; ein Linksklick öffnet weiterhin die Mediendetails. q oder Esc schließt ihn. Auf bestehenden Desktops wird cava bei Bedarf zuerst installiert.

Wenn ein angeschlossener Monitor HDR unterstützt, verwendet Eitr für Steam-Proton-Spiele standardmäßig Wayland und HDR mit PROTON_ENABLE_WAYLAND=1, PROTON_ENABLE_HDR=1 und DXVK_HDR=1. Ohne HDR-Monitor bleiben die bisherigen Vorgaben erhalten. Die Hardwareerkennung aktualisiert die erzeugte Bildschirmkonfiguration beim Auflisten oder Ändern der Bildschirme sowie vor ihrem Laden bei Anmeldung oder Neuladen. Starte eine neue Desktopsitzung und Steam neu, um geänderte Vorgaben zu übernehmen; laufendes Steam behält seine Umgebung. Aktiviere HDR im Spiel; Vollbildspiele können den Monitor auch ohne Desktop-HDR automatisch umschalten. Bei einigen Spielen fehlt unter Wayland das Steam-Overlay. Zum Abschalten für ein Spiel trage PROTON_ENABLE_WAYLAND=0 %command% in dessen Steam-Startoptionen ein. Zum Kalibrieren stellst du die maximale oder Spitzenhelligkeit des Spiels auf die HDR-Spitzenhelligkeit aus den technischen Daten deines Monitors (ein DisplayHDR-400-Monitor erreicht etwa 400 Nits) und passt danach Papierweiß oder Gesamthelligkeit nach Geschmack an. Verlieren helle Bereiche Details, senke den Spitzenwert; wirkt das Bild matt, erhöhe das Papierweiß. Browser verwenden HDR nur, wenn Desktop-HDR für ihren Monitor eingeschaltet ist; sie schalten es nie automatisch ein. HDR-Spiele im Vollbild schalten weiterhin automatisch um, wenn Desktop-HDR ausgeschaltet ist. Die HDR-Wiedergabe im Browser hängt außerdem von dessen Unterstützung und Einstellungen ab.

Erinnerungen per Sprache

Halte SUPER + Shift + D, sprich und lasse los, oder tippe unter Hauptmenü > Werkzeuge > Erinnerungen > Dem Assistenten etwas sagen…. Eitr transkribiert lokal mit dem Offline-Modell der Diktierfunktion und fragt den unter Entwicklung > Standardassistent gewählten Assistenten. Nur Transkript und Erinnerungskontext gehen an dessen Anbieter; Audio bleibt lokal und wird nach der Transkription gelöscht. Der Assistent läuft ohne Fenster über Eitrs schreibgeschützten Aufruf. Eitr prüft dessen JSON und führt Erinnerungsaktionen selbst aus; der Assistent erhält keine Werkzeuge zum Ändern von Daten. Mit Ratatoskr (Entwicklung > Standardassistent) verlässt das Transkript diesen PC nie.

Sage etwa „Erinnere mich morgen um 15 Uhr an einen Anruf“ oder „Zahnarzt am 30. Oktober um 15 Uhr, 30 Minuten vorher erinnern“. Termine melden sich standardmäßig eine Stunde vorher (oder mit dem gewünschten Vorlauf) und zur Terminzeit; einfache Erinnerungen nur zur angegebenen Zeit. Bei fehlenden Angaben oder Mehrdeutigkeit erscheint ein Terminal mit vollständig ausgeschriebenen nummerierten Optionen. Tippe die Nummer oder eine eigene Antwort, oder diktiere sie mit SUPER + D; Esc bricht ab. Ein Datum ohne Uhrzeit öffnet bei jedem Assistenten die Uhr. Eine Benachrichtigung meldet das Ergebnis. Auch Auflisten und Löschen sind möglich.

Neue Erinnerung akzeptiert außerdem tomorrow 15:00, englische Wochentage, 2026-10-30 09:00, Oct 30 15:00, 9am, in 5 minutes und every 29th. Mehrteilige Datumsangaben in der CLI in Anführungszeichen setzen. Jeder Alarm hat einen eigenen Timer; Abbrechen entfernt alle. Verpasste Alarme erscheinen bei der nächsten Anmeldung. Ein Datum ohne Uhrzeit, getippt oder gesprochen, öffnet eine kleine Uhr: eine Uhrzeit im 24-Stunden-Format HH:MM tippen; Rücktaste löscht die letzte Ziffer, Pfeiltasten ändern Stunden oder Minuten; Enter bestätigt, Esc bricht ab. Erinnerungsalarme spielen einen kurzen Ton, außer bei „Nicht stören“. Der Kalender markiert Termintage; ein Klick zeigt sofort aktualisierte Zeiten und Titel. Jede aufgeführte Erinnerung hat einen Papierkorb-Knopf: Zweimal klicken löscht eine einmalige Erinnerung; bei einer wiederholten wählt man Diesen (nur der nächste Termin) oder Alle. Escape, ein Klick daneben oder einige Sekunden ohne Eingabe behalten die Erinnerung.

Wiederholte Erinnerungen verstehen every day 08:00, every Monday 09:30, weekdays 07:00, every Monday and Thursday 09:30, every week, every month on the 15th und every year (mit Uhrzeit). In der CLI die Phrase in Anführungszeichen setzen: eitr remind "every day 08:00" Stretch. Der Assistent unterstützt Intervalle, Enddatum oder Anzahl. Fehlende Monatstage werden auf den letzten Tag begrenzt. Ortszeit und relative Vorwarnungen bleiben erhalten. Nur der nächste Termin hat Timer; nach Ausfall erscheint eine verpasste Erinnerung, ältere Termine werden übersprungen und zählen zum Limit. Die Liste zeigt nächste Zeit und Regel. Einzeltermin oder Serie löschen: eitr remind cancel ID occurrence oder eitr remind cancel ID series. Der Kalender zeigt Punkte und ↻ bei fester Höhe.

Erinnerungsbenachrichtigungen, auch verpasste Hinweise, bieten 5 Min. schlummern, 10 Min. schlummern, 1 Stunde schlummern und Schließen im Popup und im Benachrichtigungsverlauf. Schlummern plant ab dem Klick eine separate einmalige Erinnerung mit demselben Text; wiederkehrende Erinnerungen behalten ihren Zeitplan. Schließen schließt den Hinweis. Die Aktionen bleiben bis zu 24 Stunden verfügbar, danach läuft die Benachrichtigung ab.

Hauptmenü > Werkzeuge > Kalenderquellen > Kalender hinzufügen… zeigt einen Google-, Outlook- oder anderen iCal-Kalender im Kalender-Panel an, schreibgeschützt und ohne Anmeldung. Wähle den Anbieter: Google und Outlook öffnen ihre Einstellungen im Browser. Kopiere bei Google unter Einstellungen für meine Kalender > Kalender integrieren die Privatadresse im iCal-Format; veröffentliche bei Outlook unter Einstellungen > Kalender > Freigegebene Kalender einen Kalender und kopiere seinen ICS-Link. Füge die Adresse ein (https:// oder webcal://) und benenne den Kalender. Wer diese Adresse kennt, kann den Kalender lesen; Eitr speichert sie daher in einer privaten Datei und zeigt sie nie in Menüs, Benachrichtigungen oder Protokollen. Setze die Adresse beim Anbieter zurück, falls sie bekannt wird. Kalender werden bei der Anmeldung, alle 15 Minuten und beim Öffnen des Kalenderpanels (höchstens einmal pro Minute) aktualisiert. Termine von letzter Woche bis in 60 Tagen erscheinen neben den Erinnerungen mit dem Kalendernamen und ohne Papierkorb: Ändere sie in Google oder Outlook. Termine mit Uhrzeit melden sich bei Beginn mit dem Erinnerungston; ganztägige Termine melden sich nicht. Tägliche, wöchentliche, monatliche (ein Tag oder ein Wochentag wie der letzte Freitag) und jährliche Wiederholungen werden angezeigt; seltenere Regeln zeigen nur den ersten Termin. Im Menü Kalenderquellen aktualisiert Enter einen Kalender sofort, und Entf entfernt ihn nach einer Bestätigung. Zwei-Wege-Synchronisierung (Termine beim Anbieter anlegen oder ändern) wird nicht unterstützt. Das Terminal bleibt beim Kopieren im Browser geöffnet; Enter in der Übersicht fügt den Kalender hinzu, Esc bricht ab.

Plugins

Ein Plugin ist ein Git-Repository mit Skripten, Walker-Einträgen, optionalen visuellen Elementen (Kacheln, Panels, Desktop-Widgets und Leistenelemente) und optional einem Benutzerdienst; ein Repository kann mehrere Plugins enthalten. Ein Plugin läuft als du, mit allen Berechtigungen deines Kontos: Es kann deine Dateien, SSH-Schlüssel und Browserdaten lesen, sie überallhin senden und sich am Laufen halten. Eitr hat seinen Code nicht geprüft; der Code gehört seinem Autor, nicht Eitr, und jeder Plugin-Eintrag sagt das, zum Beispiel Plugin von Ada · nicht von Eitr geprüft. Füge nur Plugins von Personen und Repositorys hinzu, denen du vertraust.

Eitr fragt nach deinem Passwort nur in einem Terminal, das es für einen von dir gestarteten Schritt geöffnet hat, etwa die Systemaktualisierung, nie in einem Pop-up-Fenster. Fragt ein Plugin nach deinem Passwort, ist es nicht Eitr: Gib es nicht ein.

Hauptmenü > Plugins > Plugins hinzufügen fragt nach einer HTTPS-Git-URL oder, für ein privates Repository, nach einer SSH-URL wie git@github.com:you/plugin.git (sie nutzt deine SSH-Schlüssel über den Agenten). Das Hinzufügen braucht zwei Bestätigungen, beide mit Nein als Vorgabe. Zuerst, bevor etwas heruntergeladen wird, erklärt eine Sicherheitsseite diese Risiken; drücke Enter, um das Plugin zur Prüfung herunterzuladen. Danach beginnt die Prüfung mit der Vertrauenswarnung und etwaigen Warnungen (ein Hintergrunddienst, der bei jeder Anmeldung startet, Binärdateien), gefolgt von Manifest-Autor, Repository, genauem Commit, Git-Autor und Datum, Version, der Zahl ausführbarer Dateien und den Einträgen. Drücke Enter zum Installieren; Esc bricht in beiden Schritten ab. Vor der Bestätigung läuft kein Plugin-Code. eitr plugin add URL stellt dieselben zwei Fragen (Enter fährt fort, Esc bricht ab) und verweigert den Start ohne Terminal. Hauptmenü > Plugins > Installierte Plugins zeigt die Aktionen; die Suche in Werkzeuge findet sie ebenfalls. Das leere Menü zeigt Keine Plugins installiert.

Der Katalog installiert und aktualisiert Plugins im Fenster. Karten unter Offiziell und Community öffnen Details mit Bildern, Videos und Komponenten. Videos starten stumm und stoppen beim Schließen. Installieren und Update zeigen Quelle, vollständigen Commit, Autor, Dateien, Befehle, Warnungen und Änderungen; die optionale KI-Prüfung erscheint als Text. Plugins haben alle Berechtigungen deines Kontos. Enter bestätigt, Escape bricht ab. Installiert wird genau der geprüfte Commit; Community verwendet den im Index festgelegten Commit. Die Prüfung läuft nach 15 Minuten ab und wird beim Schließen verworfen. Installiert > Von einer Git-Adresse hinzufügen akzeptiert HTTPS oder SSH für Plugins und datenbasierte Themes, ohne Terminal.

Drücke in der Installationsprüfung A, damit dein Standardassistent eine temporäre Kopie des Repositorys als Text ohne Werkzeuge prüft. Ratatoskr und Claude können Plugins prüfen; ein nicht unterstützter Standardassistent wird in der Prüfung benannt. Claude sendet den Text an seinen Anbieter; Ratatoskr behält ihn auf diesem PC. Mit PgUp/PgDn blätterst du im Bericht. Die KI kann Probleme übersehen: Dies ist ein Hinweis, keine Freigabe; die Warnung zu vollen Zugriffsrechten gilt weiter. Enter installiert und Esc bricht ab, auch während der Prüfung. Bei Fehlern, leeren Antworten oder nach 180 Sekunden bleibt die normale Prüfung verfügbar. Nichts wird automatisch installiert.

Die Systemaktualisierung prüft nur auf neue Plugin-Commits, auch wenn alle Pakete aktuell sind, und nennt Anzahl und Aktualisierungsweg. Sie prüft keinen Plugin-Code und aktualisiert keine Plugins; Netzwerkfehler werden still ignoriert. Starte Plugins aktualisieren unter Kontrollzentrum > Plugins neben Plugins hinzufügen oder Plugins > Plugins aktualisieren, oder nutze eitr plugin update. Die Schaltfläche und Zeile „Plugins aktualisieren“ erscheinen nur, wenn die letzte Prüfung eine Aktualisierung gefunden hat. Die Markierung ↑ in der Zeile und „Aktualisierung verfügbar“ in den Details zeigen die letzte Prüfung des bestätigten Commits. Die separate Aktion behält Diffs, Risikohinweise und Bestätigungen für jedes Plugin bei.

Jede Aktualisierung beginnt mit einer Zusammenfassung: alter und neuer Commit, Commit-Betreffzeilen, geänderte Dateien mit hinzugefügten und entfernten Zeilen sowie RISIKO-Hinweise für einen hinzugefügten, geänderten oder entfernten Hintergrunddienst, jede Manifest-Änderung, neue oder geänderte ausführbare Dateien, Binärdateien und Commits eines anderen Autors als beim bestätigten Commit. Drücke d für den ganzen Diff in einem Pager (delta, wenn installiert, sonst less -R), Enter zum Aktualisieren oder Esc, um die aktuelle Version zu behalten. Wurde der Verlauf umgeschrieben, sodass der bestätigte Commit nicht Teil des neuen ist, aktualisiert Eitr nicht automatisch und nennt den Grund; entferne das Plugin und füge es erneut hinzu, wenn du ihm weiter vertraust. Nicht interaktive Aktualisierungen überspringen Plugins. Plugins > Installierte Plugins > das Plugin bietet Aktualisierung und Entfernen; Entfernen fragt nach Bestätigung und löscht Dateien, Einträge und Dienst. Dieselben Abläufe bieten eitr plugin list, eitr plugin add URL, eitr plugin update [ID] und eitr plugin remove ID.

Eitr liefert eine Plugin-Sperrliste im signierten Paket eitr-desktop aus, sodass die Paketsignatur von pacman sie schützt. Jeder Eintrag nennt ein Repository, einen Commit oder eine Plugin-ID mit einem Grund. Hinzufügen oder Aktualisieren eines gesperrten Plugins wird abgelehnt. Ein installiertes Plugin, das gesperrt wird, hält an: Seine Einträge verschwinden aus Plugins > Installierte Plugins, es lässt sich nicht starten, sein Dienst wird gestoppt und deaktiviert, und eine einzige Benachrichtigung nennt es und den Grund, mit einer Schaltfläche Entfernen. Plugins > Installierte Plugins markiert es als gesperrt; Auswählen entfernt es. Seine Dateien werden nie automatisch gelöscht. Um ein schädliches Plugin zu melden, öffne https://github.com/eitr-org/eitr/issues/new?template=malicious-plugin.yml; füge nie Passwörter, Tokens oder Schlüssel in die Meldung ein. Ein Organisationsprofil kann Plugins auch ausschalten oder nur aufgelistete Repositorys erlauben (siehe Organisationsprofile).

Plugins liegen nur unter $XDG_DATA_HOME/eitr/plugins/<id>/ (Standard ~/.local/share/eitr/plugins/); Bestätigungen unter $XDG_STATE_HOME/eitr/plugins.json. Dienste verwenden $XDG_CONFIG_HOME/systemd/user/eitr-plugin-<id>.service mit NoNewPrivileges=yes und können so über Programme wie sudo keine Rechte erlangen. Verwende nie sudo. Aktualisierungen prüfen einen separaten Kandidaten und behalten bei Ablehnung oder Fehlern den bestätigten Commit. Ein Plugin kann deine Dateien verändern; Entfernen macht diese Änderungen nicht rückgängig.

Manifest-Referenz

Version 1: Im Stamm liegt eitr-plugin.json. Nur diese Schlüssel sind erlaubt: id (Kleinbuchstaben und Ziffern, getrennt durch einzelne Bindestriche), name, description (höchstens 72 Zeichen), author, version, rows (1–20; 0–20 mit ui) und optional service, schemaVersion und hooks. Jeder Eintrag benötigt title, description (beide höchstens 72 Zeichen) und run; optional sind icon und arguments (Liste fester Zeichenketten). Ein Dienst akzeptiert nur run und optional arguments. Befehle verwenden argv, niemals Shell-Zeichenketten. run muss eine ausführbare Datei im Repository bezeichnen: Absolute Pfade und .. werden abgelehnt, ebenso jeder Symlink irgendwo im Plugin. Unbekannte oder doppelte JSON-Schlüssel werden abgelehnt. Submodule werden nicht initialisiert.

Das Beispiel unter distro/plugins/example/ enthält Manifest und notify.sh, eine Benachrichtigungsaktion, einen Theme-Hook und keinen Dienst. Kopiere es in dein Git-Repository, erstelle einen Commit und veröffentliche eine HTTPS-Git-URL, um den gesamten Installationsablauf zu testen. Es wird als Dokumentation geliefert und nicht automatisch installiert. Ein visuelles Plugin, den Visualizer, enthält die offizielle Sammlung unter https://github.com/eitr-org/eitr-plugins.

Für Skript-Manifeste gilt schemaVersion: 1, für den optionalen Abschnitt ui unten schemaVersion: 2. Ohne dieses Feld bleiben ältere Plugins kompatibel; die Prüfung zeigt einen Hinweis. Versionen über 2 benötigen ein neueres Eitr. Der Autorenleitfaden distro/PLUGINS.md (installiert als PLUGINS.md) beschreibt den stabilen Vertrag der Version 1.

Plugins können Hooks für theme-changed, wallpaper-changed, after-update und login deklarieren. Sie laufen nach der Aktion im Hintergrund, bei Anmeldung einmal pro Desktopsitzung, mit 30 Sekunden Zeitlimit. Fehler stehen in $XDG_STATE_HOME/eitr/plugin-hooks.log und lassen die Aktion nicht fehlschlagen. Die Prüfung zeigt Hooks an; neue oder geänderte Hooks erhalten RISK-Markierungen bei Updates. Sperrliste und Organisationsrichtlinien gelten auch für Hooks.

Visuelle Plugins

Schema-Version 2 kann Kacheln unter Kontrollzentrum > Allgemein > Plugins und daraus geöffnete Panels hinzufügen. Sie können Eitrs Farben, Schrift und Ecken übernehmen; Widgets und Leistenelemente erscheinen erst, wenn du sie hinzufügst. Die Prüfung zeigt jede QML-Datei und ihren vollständigen Quelltext vor der Installation. Updates zeigen einen blätterbaren Diff und das neue QML vor der Bestätigung; QML-Änderungen erzeugen RISK-Hinweise. QML ist keine Sandbox: Es läuft innerhalb der Leiste mit deinen vollen Rechten. Vertraue dem Autor; Schleifen und native Abstürze kann der Loader nicht isolieren.

Bei einem Ladefehler erscheint ein Hinweis statt des Inhalts; das Protokoll liegt unter $XDG_STATE_HOME/eitr/plugin-ui.log. Nach drei Ladefehlern oder gemeldeten Fehlern werden die visuellen Komponenten des Plugins dauerhaft deaktiviert, auch über Updates hinweg. Wähle Wieder aktivieren unter Kontrollzentrum > Plugins, oder führe eitr plugin enable-ui ID aus. Vor diesem Grenzwert Allgemein schließen und erneut öffnen, um es nochmals zu versuchen. Aktionen, Hooks und Dienste bleiben unabhängig. Plugins stehen nach den bestehenden Abschnitten von Allgemein. Panels ersetzen die Kacheln durch einen Titel und einen Zurück-Pfeil; Zurück oder Escape führt zu den Kacheln zurück, ein weiteres Escape schließt das Kontrollzentrum. Hohe Panels scrollen innerhalb der Unteransicht. Das v2-Beispiel enthält eine Hello-Kachel und ein Statuspanel. v1-Plugins bleiben unverändert unterstützt. Schema und schmale Stil-/Daten-API stehen in distro/PLUGINS.md; die API ist eine unterstützte Schnittstelle, keine Sicherheitsgrenze.

Ein Plugin mit Schema v2 kann audio-spectrum anfordern. Die Prüfung erklärt, dass nur Pegel des Systemklangs gelesen werden: Es wird kein Ton aufgenommen oder gesendet, und der Host erfasst niemals das Mikrofon. Diese neue Fähigkeit erzeugt einen RISK-Hinweis. Alle sichtbaren Verbraucher teilen einen Anbieter für das Wiedergabespektrum; Plugins fordern 8–128 Balken und bis zu 60 Bilder pro Sekunde an. Ohne sichtbare Verbraucher stoppt er. Ein deklarierter dataStream-Befehl liefert Textzeilen, solange seine Komponente sichtbar ist, begrenzt auf 60 Zeilen pro Sekunde und 4096 Bytes pro Zeile. Die Prüfung zeigt den Befehl; Änderungen erzeugen RISK-Hinweise. Verborgene Komponenten stoppen Streams und Kindprozessgruppen; nach Fehlern erfolgen neue Versuche mit wachsender Wartezeit. Einzelheiten für Autoren stehen in distro/PLUGINS.md.

Plugin-Verwaltung und Widget-Optionen

Kontrollzentrum > Plugins zeigt jedes installierte Plugin mit Symbol, Autor, Version, Beschreibung und Status. Vorschau öffnet das Bildschirmfoto. Aktivieren/Deaktivieren erhält Positionen und stoppt oder startet Dienste, Walker-Einträge, Hooks und visuelle Komponenten; per CLI: eitr plugin enable ID oder eitr plugin disable ID. Plugins hinzufügen, Aktualisieren und Entfernen öffnen die geprüften Terminalabläufe; Entfernen verlangt Bestätigung. Allgemein behält nur Plugin-Kacheln. Visuelle Fehler haben eine unabhängige Aktion zum erneuten Aktivieren.

Widgets werden je Monitor und Leistenelemente unter dem jeweiligen Plugin hinzugefügt. Position bearbeiten hebt das Widget vorübergehend über Fenster: Titel oder Größengriff ziehen, danach Fertig oder Escape. Die Bewegung ist kontinuierlich; beim Loslassen rastet die Position am Desktopabstand ein und wird gespeichert. Rechtsklick hinter Fenstern oder während der Bearbeitung öffnet Größe (90% / 110%, mit Seitenverhältnis und Mittelpunkt innerhalb der Bildschirmgrenzen), Volle Breite, Hintergrund Panel/Transparent, Über Fenstern anzeigen, Plugin-Optionen und Vom Desktop entfernen. Volle Breite nutzt die größte passende proportionale Größe. Widgets über Fenstern lassen Klicks durch; ihre Optionen stehen unter Plugins. Widgets bearbeiten dort oder in Walker macht alle interaktiv bis Fertig oder Escape (plugin-widgets edit / done per IPC). Getrennte Monitore behalten Positionen.

Transparente Hintergründe haben keine Host-Farbe, Umrandung oder Unschärfe; Bearbeitungsgriffe bleiben sichtbar. Neue v2-Plugins benötigen ein quadratisches PNG/SVG-Symbol (bis 512 KiB, PNG 64–1024 px); optionale Vorschauen sind PNG/JPEG bis 2 MiB und 3840 px je Achse, homepage nutzt HTTPS. Bestehende Plugins ohne Symbol erhalten ein allgemeines Symbol und einen Prüfhinweis. Die API bietet api.setMenu([{id, text, checked}]) und api.menuTriggered(id) für Optionen wie Wave/Terminal. Siehe distro/PLUGINS.md.

Autoren wählen Farben, Bilder, Shader und Animationen frei. Themenhilfen (api.palette, color0–15, benannte Rollen, Schrift, Größen, Radius und themeChanged) sind optional. Widgets und Panels verwenden standardmäßig surface: "none"; "panel" wählt den Eitr-Hintergrund. Eine ausdrücklich gespeicherte Widgetwahl hat Vorrang, sonst gilt die Deklaration. Das Kontrollzentrum behält seinen äußeren Rahmen ohne zusätzliche Dekoration im Pluginbereich. header: false blendet die Kopfzeile aus; Zurück/Escape funktionieren weiterhin. Kacheln verwenden standardmäßig look: "eitr"; "custom" zeichnet den ganzen festen Platz, mit Aktivierung und Fokusring vom Host. Leistenelemente erhalten keine Färbung oder Hoverfüllung. Relative QML-Bilder liegen im Pluginordner. Grenzen, zentrierte Uhr, Prüfung, Fähigkeiten und Fehlerbehandlung bleiben bestehen. Das Beispiel zeigt beide Kachelstile.