gnuslashlinux_tui_suite

GNUSlashLinux TUI Suite

Die GNUSlashLinux TUI Suite ist eine zentrale, interaktive Systemsteuerung für das Terminal. Sie bündelt wichtige Administrations- und Alltagswerkzeuge in einer einheitlichen, tastaturgesteuerten Oberfläche. Die Suite basiert auf bash und nutzt die CLI-Werkzeuge gum und fzf für flüssige, visuelle Menüs.

Keybinding

Du kannst die Suite systemweit direkt aus jeder Anwendung heraus mit der folgenden Tastenkombination öffnen:

• MOD + Shift + s

---

🇩🇪 Komponenten & Funktionen (Deutsch)

1. git-sync — Interaktiver Git Helper

Ein smarter Git-Assistent, der das Repository-Management automatisiert:

• Repository-Suche: Erkennt automatisch, ob sich das aktuelle Verzeichnis in einem Git-Repository befindet. Falls nicht, lässt sich über fd/find und fzf komfortabel nach lokalen Projekten suchen.
• Visuelles Staging: Zeigt veränderte Dateien an. Der Nutzer wählt via Space/Tab gezielt aus, welche Dateien committet werden sollen.
• Commit & Push: Erfragt eine Commit-Nachricht (mit automatischem Zeitstempel-Fallback) und führt anschließend direkt einen sicheren git push zum Remote-Server aus.

2. hx-open — Workspace & Config Launcher

Ein absturzsicherer Schnellstarter für den Helix-Texteditor:

• Konfigurations-Direktzugriff: Erlaubt das sofortige Editieren wichtiger Systemdateien wie der Fish-Shell-Konfiguration (config.fish), der .bashrc oder der Niri Window Manager Konfigurationen.
• Projektsuche: Durchsucht das Home-Verzeichnis nach Dateien und öffnet die Auswahl direkt im Helix-Editor. Abbrüche (ESC) im Suchmenü werden sicher abgefangen.

3. pass-manager — Passwort Store Migrations-Tool

Ein sicherer Assistent zum Sichern und Wiederherstellen deines pass-Passwortspeichers beim PC-Wechsel:

• Export (Alter PC): Entschlüsselt alle lokalen .gpg-Passwörter temporär und schreibt sie strukturiert in eine unverschlüsselte Klartextdatei.
• Import & Setup (Neuer PC): Hilft bei der Generierung eines neuen GPG-Schlüssels, initialisiert den Passwort-Store neu und liest die exportierte Datei ein, um alle Einträge für das neue System frisch zu verschlüsseln.
• Sicheres Löschen: Bietet am Ende an, die unverschlüsselte Export-Datei via shred unwiderruflich von der Festplatte zu fegen.

4. pkexec-wl — Wayland Root-App Launcher

Ermöglicht das sichere Starten von grafischen Programmen mit Root-Rechten unter Wayland:

• X11-Kompatibilität: Setzt im Hintergrund Umgebungsvariablen (DISPLAY, XAUTHORITY, QT_QPA_PLATFORM="xcb", GDK_BACKEND="x11") und regelt die xhost-Berechtigungen, damit Root-Apps unter Wayland fehlerfrei visuell starten.
• App-Filter: Liest installierte .desktop-Dateien ein und bietet eine interaktive Suchliste aller verfügbaren System-Apps.

5. smart-fire — Find & Replace Helper

Ein mächtiges Suchen-und-Ersetzen-Werkzeug für Quellcode und Textdateien:

• Schnelle Suche: Durchsucht Ordner rekursiv mittels rg (Ripgrep) oder grep nach regulären Ausdrücken oder Suchbegriffen.
• Interaktiver Filter: Die Trefferergebnisse werden in einer fzf-Liste dargestellt, um die Zielauswahl präzise einzugrenzen.
• Massen-Ersetzung: Ersetzt die Suchtreffer wahlweise in allen Dateien oder nur in den gefilterten Ergebnissen via sed.

6. toggle-language — System Sprachauswahl

Ein Admin-Werkzeug zur schnellen Anpassung des System-Standorts und der Tastaturbelegung:

• Statusübersicht: Zeigt die aktuelle System-Locale, die Keymap und das konfigurierte Papierformat an.
• Bilinguale Profile: Schaltet das System komplett zwischen Deutsch (de_DE.UTF-8, A4-Papier, deutsche Keymap) und Englisch (en_US.UTF-8, Letter-Papier, US-Keymap) um.
• Persistenz: Schreibt die Änderungen direkt in Systemdateien wie /etc/vconsole.conf, /etc/papersize und /etc/locale.conf. Ein anschließender Logout aus Niri WM kann direkt bestätigt werden.

7. toggle-shell — Shell Konfigurator

Erlaubt den unkomplizierten Wechsel der Standard-Shell für das Benutzerkonto:

• Auswahl: Schaltet die Standard-Shell interaktiv zwischen bash und fish um.
• Validierung: Prüft, ob die gewählte Shell bereits aktiv ist, fordert das Benutzerpasswort an und führt den Wechsel sicher über chsh aus.

8. media-fire — TUI Medien-Konverter

Ein Terminal-Frontend für ffmpeg, yt-dlp und imagemagick zur schnellen Medienbearbeitung:

• Web-Downloads: Lädt Videos oder reine MP3-Audiostreams von URLs (z.B. YouTube) in bester Qualität herunter.
• Bildbearbeitung: Konvertiert Bilder in das moderne WebP-Format, skaliert Abmessungen (Pixel oder Prozent) oder bereinigt Dateien von EXIF-Metadaten.
• Videobearbeitung: Wandelt Videos in animierte GIFs um, extrahiert die Tonspur als MP3 oder schneidet Videos verlustfrei (trim) nach Zeitangaben.
• Audio-Konvertierung: Konvertiert Audiodateien wahlweise in MP3 oder in das hocheffiziente, moderne Opus-Format.

---

🇬🇧 Components & Functions (English)

1. git-sync — Interactive Git Helper

A smart Git assistant that automates repository management:

• Repository Lookup: Automatically detects if the current directory is a Git repository. If not, it uses fd/find and fzf to search for local projects.
• Visual Staging: Displays modified files. Users can select specific files to stage/commit using Space/Tab.
• Commit & Push: Prompts for a commit message (with an automatic timestamp fallback) and instantly pushes changes to the remote server.

2. hx-open — Workspace & Config Launcher

A robust, crash-proof quick launcher for the Helix text editor:

• Direct Config Access: Allows immediate editing of vital system files such as the Fish shell config (config.fish), .bashrc, or Niri Window Manager configurations.
• Project Search: Recursively searches the home directory for files and opens the selection straight inside Helix. Mid-search cancellations (ESC) are handled safely without crashing the menu.

3. pass-manager — Password Store Migration Tool

A secure utility to backup and restore your pass password store when migrating to a new PC:

• Export (Old PC): Temporarily decrypts all local .gpg credentials and saves them into a structured plaintext file.
• Import & Setup (New PC): Helps generate a fresh GPG key, re-initializes the password store, and imports the plaintext file to re-encrypt all entries for the new system.
• Secure Wiping: Offers to permanently wipe (shred) the unencrypted source file from the disk once the import is finished.

4. pkexec-wl — Wayland Root-App Launcher

Enables a secure way to launch graphical applications with root privileges under Wayland:

• X11 Compatibility: Configures environment variables (DISPLAY, XAUTHORITY, QT_QPA_PLATFORM="xcb", GDK_BACKEND="x11") and manages xhost permissions dynamically to prevent GUI errors when running root apps on Wayland.
• App Filtering: Parses installed .desktop files to present an interactive search list of all available system applications.

5. smart-fire — Find & Replace Helper

A powerful find-and-replace tool for source code and text files:

• Fast Search: Scans directories recursively using rg (Ripgrep) or grep for specific terms or regular expressions.
• Interactive Filtering: Search results are piped into fzf to easily narrow down or select specific matches.
• Bulk Replacement: Replaces the text using sed, applying changes either to all initial matches or exclusively to the filtered selection.

6. toggle-language — System Language Switcher

An administrative tool to quickly switch system locales and keyboard layouts:

• Status Overview: Displays the current active system locale, keymap, and paper size.
• Bilingual Profiles: Switches the entire system between German (de_DE.UTF-8, A4 paper, German keymap) and English (en_US.UTF-8, Letter paper, US keymap).
• Persistence: Commits changes directly to core configuration files (e.g., /etc/vconsole.conf, /etc/papersize, /etc/locale.conf). It also offers an immediate logout option from Niri WM to apply changes.

7. toggle-shell — Shell Configurator

Allows users to easily change their account's default shell environment:

• Selection: Interactively switches the default system shell between bash and fish.
• Validation: Checks if the target shell is already active, prompts for the user password, and executes the change safely via chsh.

8. media-fire — TUI Media Converter

A convenient terminal frontend for ffmpeg, yt-dlp, and imagemagick to handle media files on the fly:

• Web Downloads: Downloads video or extract pure MP3 audio streams from URLs (e.g., YouTube) at maximum quality.
• Image Processing: Converts images to the modern WebP format, resizes dimensions (via pixels or percentages), or strips EXIF metadata completely.
• Video Processing: Converts video files into animated GIFs, extracts audio tracks to MP3, or performs lossless video trimming based on timestamps.
• Audio Conversion: Encodes audio tracks into standard MP3 or highly efficient, modern Opus formats.