====== GuideOS Shutdown-Tool ======

Das **GuideOS Shutdown-Tool** ist ein grafisches Werkzeug zum zeitgesteuerten Herunterfahren des Systems. Es bietet einen Countdown mit Abbruch-Möglichkeit und ist ideal für geplante Systemabschaltungen.

===== Was macht das Tool? =====

<WRAP left round info 70%>
  * **Zeitgesteuertes Herunterfahren** – System fährt nach eingestellter Zeit automatisch herunter
  * **Flexibel einstellbar** – Zeit in Stunden, Minuten und Sekunden
  * **Countdown-Anzeige** – Zeigt verbleibende Zeit mit Fortschrittsbalken
  * **Jederzeit abbrechbar** – Shutdown kann während des Countdowns gestoppt werden
</WRAP>


===== Voraussetzungen =====

  * Root-Rechte (Sudo-Passwort)
  * **Zenity** (für die grafische Oberfläche)

===== Benutzung =====

==== Shutdown einrichten ====

  - **GuideOS Shutdown-Tool** starten
  - **Sudo-Passwort** eingeben
  - Im Formular Zeit einstellen:
    * **Stunden** – Anzahl der Stunden bis zum Herunterfahren
    * **Minuten** – Anzahl der Minuten
    * **Sekunden** – Anzahl der Sekunden
  - Eingabe bestätigen
  - Bestätigungsfenster zeigt die eingestellte Zeit an
  - Countdown startet automatisch

<code>
Beispiel:
Stunden: 2
Minuten: 30
Sekunden: 0

→ System fährt in 2 Stunden und 30 Minuten herunter
</code>

==== Countdown beobachten ====

Nach dem Start erscheint ein Fortschrittsbalken mit:

  * **Prozentanzeige** – Zeigt Fortschritt des Countdowns
  * **Verbleibende Zeit** – Im Format HH:MM:SS (z.B. 01:23:45)
  * **Abbrechen-Button** – Stoppt den Shutdown sofort

==== Shutdown abbrechen ====

  - Während des Countdowns auf **"Abbrechen"** klicken
  - Bestätigung erscheint: "Der Shutdown wurde abgebrochen"
  - System läuft normal weiter

===== Anwendungsbeispiele =====

^ Situation ^ Einstellung ^ Verwendung ^
| Download über Nacht | 4 Stunden | System fährt herunter wenn Download fertig ist |
| Energie sparen | 30 Minuten | System schaltet sich ab während Pause |
| Automatische Updates | 2 Stunden | Genug Zeit für Updates, dann Shutdown |
| Film zu Ende schauen | 1 Stunde 45 Min | Nach Film schaltet System automatisch ab |

===== Tipps zur Zeiteinstellung =====

==== Leere Felder ====

Nicht ausgefüllte Felder werden automatisch als **0** gewertet. Beispiele:

  * Nur Minuten eingeben (Stunden und Sekunden leer) → Shutdown nach X Minuten
  * Nur Stunden eingeben → Shutdown nach X Stunden

==== Schneller Shutdown ====

Für schnelles Herunterfahren:
  * Stunden: 0
  * Minuten: 0
  * Sekunden: 30

→ System fährt in 30 Sekunden herunter

==== Langfristiger Shutdown ====

Für über Nacht:
  * Stunden: 8
  * Minuten: 0
  * Sekunden: 0

→ System fährt in 8 Stunden herunter

===== Wichtige Hinweise =====

<WRAP left round important 60%>
  * **Arbeit speichern**: Vor dem Start alle offenen Dokumente speichern
  * **Programme schließen**: Wichtige Anwendungen vorher beenden
  * **Abbrechen möglich**: Shutdown kann jederzeit gestoppt werden
  * **Nur Zahlen**: Alle Felder akzeptieren nur Ziffern (0-9)
  * **Mindestzeit**: Mindestens 1 Sekunde muss eingestellt werden

</WRAP>

===== Fehlerbehandlung =====

^ Fehlermeldung ^ Ursache ^ Lösung ^
| "Es wurde kein Passwort eingegeben" | Passwortfeld leer gelassen | Sudo-Passwort eingeben |
| "Falsches Sudo-Passwort" | Passwort nicht korrekt | Tool neu starten, korrektes Passwort eingeben |
| "Bitte gib nur Zahlen ein" | Buchstaben in Zeitfeldern | Nur Ziffern verwenden |
| "Zeit muss größer als 0 sein" | Alle Felder auf 0 | Mindestens 1 Sekunde einstellen |

===== Was passiert beim Shutdown? =====

  - Countdown läuft ab
  - Bei 00:00:00 wird automatisch ''shutdown -h now'' ausgeführt
  - System fährt sofort herunter
  - Alle Programme werden beendet
  - Computer schaltet sich aus

===== Projekt =====

Teil des **GuideOS** Projekts\\
Fokus: Einfache Zeitsteuerung für System-Shutdown ohne Terminal