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

Primo startet beim ersten Login automatisch über eine Autostart-Datei in ~/.config/autostart/primo-di-tutto.desktop .

Ü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

Das Fenster teilt sich in zwei Bereiche:

• Tab-Wechsel: Klick auf Sidebar-Button
• Aktiver Tab: Hervorgehoben mit farbigem Hintergrund
• Transition: Slide-Animation (300ms) beim Wechsel

Anzeige: Nur beim ersten Start (firstrun=yes)

Funktion: Begrüßt neue Nutzer und führt in GuideOS ein

—

Zweck: Dashboard mit Systemübersicht

Features:

• Schneller Überblick über Systemzustand
• Zentrale Informationen auf einen Blick

—

Zweck: Alltägliche Systemwerkzeuge

Features:

• Systeminformationen
• Wartungsfunktionen
• Grundlegende Systemeinstellungen (Cinnamon)

—

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)

—

Zweck: Erweiterte Systemverwaltung

Zielgruppe: Fortgeschrittene Nutzer

Features:

• Tiefergehende Systemkonfiguration
• Admin-Tools für Power-User

—

Zweck: Software-Installation und -Verwaltung

Unterstützte Paketformate:

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

—

Zweck: Anpassung der Desktop-Optik

Features:

• Theme-Verwaltung
• Desktop-Personalisierung
• GTK-Theme-Erkennung (via gsettings)
• Cinnamon-Version-Erkennung

—

Zweck: Identifikation großer Dateien und Ordner

Features:

• Speicherplatz-Analyse
• Auflistung speicherhungriger Verzeichnisse
• Hilfe bei Datenträger-Bereinigung

—

Zweck: Nützliche Web-Ressourcen

Features:

• GuideOS-Links
• Community-Ressourcen
• Dokumentation

—

Zweck: Community-Beteiligung

Features:

• Beitragsmöglichkeiten
• Entwickler-Informationen
• GitHub-Repository

~/.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

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.

—

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:

1. Prüfe Log-Datei: ~/.primo/primo.log
2. Starte über Terminal für direkte Fehlerausgabe
3. 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

—

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

• Cinnamon (automatische Erkennung)
• GNOME
• Andere GTK4-kompatible Desktops

—

• 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

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]

—

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: 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

Copyright: © 2024-2026 GuideOS

Lizenz: GNU GPL 3.0

Application-ID: io.github.guideos.primo

Entwickelt von: GuideOS Community & Core Team