====== Primo Di Tutto ====== {{ :800px-primo.png?400|}} **Primo** ist das zentrale Einstellungs- und Verwaltungstool für GuideOS. Die Anwendung bietet Linux-Einsteigern einen einfachen Zugang zu Systemkonfiguration, Software-Installation und Hardware-Verwaltung. **Entwickler:** actionschnitzel / GuideOS Community **Lizenz:** GPL 3.0 **Website:** https://guideos.de ===== Installation & Start ===== ==== Systemstart ==== Primo startet beim ersten Login automatisch über eine Autostart-Datei in ''~/.config/autostart/primo-di-tutto.desktop'' . ==== Manueller Start ==== Über das Menü oder im Terminal. # Vollständige Anwendung primo-di-tutto # Oder direkt über Python python3 /usr/lib/guideos/primo-di-tutto/src/main_gtk.py ===== Benutzeroberfläche ===== ==== Hauptfenster ==== Das Fenster teilt sich in zwei Bereiche: ^ **Element** ^ **Beschreibung** ^ | **Sidebar** | Linke Navigationsleiste mit Tab-Buttons | | **Content** | Rechter Inhaltsbereich mit Tab-Inhalten | | **Über-Button** | Oben rechts in der Sidebar (? Symbol) | ==== Navigation ==== * **Tab-Wechsel:** Klick auf Sidebar-Button * **Aktiver Tab:** Hervorgehoben mit farbigem Hintergrund * **Transition:** Slide-Animation (300ms) beim Wechsel ===== Tabs im Detail ===== ==== 1. Willkommen ==== **Anzeige:** Nur beim ersten Start (''firstrun=yes'') **Funktion:** Begrüßt neue Nutzer und führt in GuideOS ein --- ==== 2. Übersicht (Dash) ==== **Zweck:** Dashboard mit Systemübersicht **Features:** * Schneller Überblick über Systemzustand * Zentrale Informationen auf einen Blick --- ==== 3. Werkzeuge (System) ==== **Zweck:** Alltägliche Systemwerkzeuge **Features:** * Systeminformationen * Wartungsfunktionen * Grundlegende Systemeinstellungen (Cinnamon) --- ==== 4. Geräte (Devices) ==== **Zweck:** Hardware-Verwaltung und Informationen **Erkannte Hardware:** * CPU-Typ, Kerne und Threads * RAM (Gesamt/Verfügbar in MB) * Festplatten/SSDs mit Speicherplatz * GPU mit Hersteller und Modell * GPU-Treiber (NVIDIA, AMD, Intel) * GPU-Speicher * Netzwerk (LAN/WAN IPv4/IPv6) **Unterstützte GPUs:** * NVIDIA (mit Version aus ''/proc/driver/nvidia/version'') * AMD (amdgpu) * Intel (i915, iris, integrierte GPUs) * Nouveau (Open-Source NVIDIA) --- ==== 5. Admin (Expert Tools) ==== **Zweck:** Erweiterte Systemverwaltung **Zielgruppe:** Fortgeschrittene Nutzer **Features:** * Tiefergehende Systemkonfiguration * Admin-Tools für Power-User --- ==== 6. Software-Empfehlungen ==== **Zweck:** Software-Installation und -Verwaltung **Unterstützte Paketformate:** ^ Format ^ Verwaltung ^ Erkennungsmethode ^ | **Flatpak** | Installation/Deinstallation | ''/bin/flatpak'' vorhanden | | **DEB (APT)** | Installation/Deinstallation | APT-Cache-Abfrage | | **Snap** | Installation/Deinstallation | ''/bin/snap'' vorhanden | **Funktionen:** * Anzeige installierter Software * Installation neuer Anwendungen * Deinstallation bestehender Pakete **Flatpak-Features:** * Automatische Remote-Liste (Architektur-spezifisch) * Cache-System mit 5s Standard-TTL * Internet-Verfügbarkeitsprüfung vor Sync * Gespeicherte Remote-Daten in ''~/.primo/flatremote_data.json'' * Installierte Apps in ''~/.primo/flatpak_installed.json'' **APT-Features:** * Zählung installierter .deb-Pakete * APT-Cache-Abfrage * Nala-Unterstützung (falls installiert) **Snap-Features:** * Paket-Zählung * Liste installierter Snaps --- ==== 7. Erscheinungsbild (Look) ==== **Zweck:** Anpassung der Desktop-Optik **Features:** * Theme-Verwaltung * Desktop-Personalisierung * GTK-Theme-Erkennung (via gsettings) * Cinnamon-Version-Erkennung --- ==== 8. Speicherfresser (Large Folders) ==== **Zweck:** Identifikation großer Dateien und Ordner **Features:** * Speicherplatz-Analyse * Auflistung speicherhungriger Verzeichnisse * Hilfe bei Datenträger-Bereinigung --- ==== 9. Links ==== **Zweck:** Nützliche Web-Ressourcen **Features:** * GuideOS-Links * Community-Ressourcen * Dokumentation --- ==== 10. Mitmachen (Contrib) ==== **Zweck:** Community-Beteiligung **Features:** * Beitragsmöglichkeiten * Entwickler-Informationen * GitHub-Repository ===== Konfiguration ===== ==== Verzeichnisse ==== ~/.primo/ # Hauptverzeichnis ├── primo.conf # Konfigurationsdatei ├── primo.log # Debug-Log ├── flatpak_installed.json # Flatpak-Cache └── flatremote_data.json # Flatpak-Remote-Cache ==== Config-Datei ==== ''~/.primo/primo.conf'': firstrun=yes # Zeigt Welcome-Tab beim nächsten Start firstrun=no # Überspringt Welcome-Tab **Erststart-Verhalten:** * Bei ''firstrun=yes'': Welcome-Tab wird angezeigt * Autostart-Datei wird automatisch aktiviert * Nach erstem Durchlauf: Änderung auf ''firstrun=no'' ==== Autostart-Steuerung ==== Die Desktop-Entry-Datei befindet sich in: ''~/.config/autostart/primo-di-tutto.desktop'' **Inhalt:** [Desktop Entry] Type=Application Exec=primo-di-tutto X-GNOME-Autostart-enabled=true NoDisplay=false Hidden=false Name[de_DE]=primo-di-tutto.desktop Comment[de_DE]=Keine Beschreibung X-GNOME-Autostart-Delay=0 **Autostart deaktivieren:** Ändere ''X-GNOME-Autostart-enabled=true'' zu ''false''. --- ===== Fehlerbehebung ===== ==== Häufige Probleme ==== **Problem:** GTK-Bibliotheken fehlen **Fehlermeldung:** ''FEHLER: GTK4/Adwaita-Bibliotheken konnten nicht geladen werden!'' **Lösung:** sudo apt install python3-gi gir1.2-gtk-4.0 gir1.2-adw-1 --- **Problem:** Primo-Module nicht gefunden **Fehlermeldung:** ''FEHLER: Primo-Module konnten nicht geladen werden!'' **Lösung:** Stelle sicher, dass du im richtigen Verzeichnis bist: cd /usr/lib/guideos/primo-di-tutto/src python3 main_gtk.py --- **Problem:** Fenster startet nicht **Lösung:** - Prüfe Log-Datei: ''~/.primo/primo.log'' - Starte über Terminal für direkte Fehlerausgabe - Stelle sicher, dass X11/Wayland läuft --- **Problem:** Flatpak-Liste leer **Ursache:** Keine Internet-Verbindung **Lösung:** * Prüfe Netzwerkverbindung * Cache-Datei wird beim nächsten Sync aktualisiert * Offline-Modus nutzt letzte gespeicherte Daten --- ===== Systemanforderungen ===== ==== Abhängigkeiten ==== **Python-Bibliotheken:** * ''python3-gi'' - GObject Introspection * ''gi.repository'' - GTK/Adwaita Bindings * ''psutil'' - Systeminformationen * ''requests'' - HTTP-Anfragen * ''apt'' (Python-Modul) - APT-Integration **System-Pakete:** * ''gir1.2-gtk-4.0'' - GTK 4 * ''gir1.2-adw-1'' - Libadwaita * Optional: ''flatpak'', ''snap'', ''nala'' ==== Unterstützte Desktops ==== * Cinnamon (automatische Erkennung) * GNOME * Andere GTK4-kompatible Desktops --- ===== Tipps & Tricks ===== ==== Performance ==== * **Cache-System:** Flatpak- und APT-Daten werden 5 Sekunden gecacht * **Lazy Loading:** Hardware-Infos werden nur bei Bedarf geladen * **Offline-Modus:** Flatpak nutzt Cache bei fehlender Internet-Verbindung ==== Erweiterte Nutzung ==== **Einzelne Tabs als Shortcuts:** Erstelle eigene Desktop-Entries für häufig genutzte Tabs: [Desktop Entry] Name=Primo Software Exec=python3 /usr/lib/guideos/primo-di-tutto/src/main_standalone.py --tab software Icon=primo-di-tutto-logo Type=Application Categories=Settings; **Verfügbare Tab-IDs:** * ''welcome'', ''dash'', ''system'', ''devices'', ''admin'' * ''software'', ''look'', ''largefolders'', ''links'', ''contrib'' [file:18] --- ===== Benachrichtigungen ===== Primo kann System-Benachrichtigungen senden: **Urgency-Level:** * NORMAL * LOW * CRITICAL [file:19] **Funktion:** send_notification( message="Text", title="Primo Di Tutto", urgency=NotificationUrgency.NORMAL ) ===== Support & Community ===== **Support:** [[https://forum.linuxguides.de/index.php?board/47-guideos/ | Linux Guides Community]] **Bug-Reports:** https://github.com/guideos/primo-di-tutto/issues **Website:** https://guideos.de **Entwickler:** actionschnitzel **Dokumentation:** Dieses Wiki **Log-Datei bei Problemen:** ''~/.primo/primo.log'' ===== Lizenz & Copyright ===== **Copyright:** © 2024-2026 GuideOS **Lizenz:** GNU GPL 3.0 **Application-ID:** ''io.github.guideos.primo'' **Entwickelt von:** GuideOS Community & Core Team