Dokumentation

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== 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.

<block round box 60%>
<code bash>
# Vollständige Anwendung
primo-di-tutto

# Oder direkt über Python
python3 /usr/lib/guideos/primo-di-tutto/src/main_gtk.py
</code>

</block>


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

<block round box 60%>
<code>
~/.primo/                   # Hauptverzeichnis
├── primo.conf              # Konfigurationsdatei
├── primo.log               # Debug-Log
├── flatpak_installed.json  # Flatpak-Cache
└── flatremote_data.json    # Flatpak-Remote-Cache
</code>
</block>


==== Config-Datei ====

''~/.primo/primo.conf'':

<block round box 60%>
<code>
firstrun=yes    # Zeigt Welcome-Tab beim nächsten Start
firstrun=no     # Überspringt Welcome-Tab
</code>
</block>


**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:**
<block round box 60%>
<code ini>
[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
</code>
</block>


**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:**
<block round box 60%>
<code bash>
sudo apt install python3-gi gir1.2-gtk-4.0 gir1.2-adw-1
</code>
</block>


---

**Problem:** Primo-Module nicht gefunden

**Fehlermeldung:**

''FEHLER: Primo-Module konnten nicht geladen werden!''

**Lösung:** Stelle sicher, dass du im richtigen Verzeichnis bist:
<block round box 60%>
<code bash>
cd /usr/lib/guideos/primo-di-tutto/src
python3 main_gtk.py
</code>
</block>


---

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

<block round box 60%>
<code ini>
[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;
</code>
</block>


**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:**
<block round box 60%>
<code python>
send_notification(
    message="Text",
    title="Primo Di Tutto",
    urgency=NotificationUrgency.NORMAL
)
</code>
</block>



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