Der GuideOS Bildschirmfoto-Editor ist ein Python/GTK3-basiertes Screenshot-Tool mit integriertem Editor für den Cinnamon Desktop [file:11].

Das Tool ermöglicht das Erstellen von Screenshots mit präziser Bereichsauswahl und bietet einen integrierten Editor zum Annotieren der Bilder. Besonders geeignet für Dokumentationen, Support, Tutorials und technische Anleitungen. Unterstützt Multi-Monitor-Setups und Wayland-Fallback.

• Screenshot-Aufnahme: Bereichsauswahl mit Live-Größenanzeige
• Multi-Monitor: Automatische Erkennung aller angeschlossenen Bildschirme
• Annotations-Werkzeuge: Linien, Rechtecke, Kreise, Pfeile, Text, Marker
• Lupe: Vergrößert Details für präzise Markierungen
• Undo/Redo: Schritte rückgängig machen oder wiederholen
• Zoom-Funktion: Bild vergrößern/verkleinern mit Strg + Mausrad
• Zwischenablage: Bild direkt in die Zwischenablage kopieren
• PNG-Export: Speichern mit Zeitstempel-Dateinamen
• Request-Modus: JSON-basierte Ausgabe für Automatisierung

guideos-screenshot-editor

Oder aus dem Anwendungsmenü starten.

1. Programm startet mit Hauptfenster
2. „Anklicken, um einen Bereich auszuwählen“ Button klicken
3. Bildschirm wird blau-transparent überlagert
4. Mit Maus Bereich aufziehen (Drag & Drop)
5. Live-Anzeige zeigt Größe in Pixel (z.B. „1920 × 1080“)
6. Bei Multi-Monitor: Monitor-Nummer wird angezeigt (z.B. „Monitor 2“)
7. Enter oder Space drücken zum Bestätigen
8. ESC zum Abbrechen

Nach der Bereichsauswahl öffnet sich der Editor mit folgenden Werkzeugen:

Werkzeug	Symbol	Funktion	Verwendung
Linie		Gerade Linien zeichnen	Klicken und ziehen
Rechteck		Rechtecke zeichnen	Klicken und ziehen
Kreis		Ellipsen/Kreise zeichnen	Klicken und ziehen
Pfeil		Pfeile mit Spitze	Klicken und ziehen
Text		Text hinzufügen	Klicken → Text eingeben
Marker		Halbtransparent markieren	Klicken und ziehen
Lupe		Details vergrößern	Über Bereich bewegen

In der Werkzeugleiste verfügbar:

• Farbwahl: Klick auf Farb-Button öffnet Farbauswahl
• Liniendicke: Dropdown mit 1-10 Pixel (Standard: 3 px)
• Textgröße: Dropdown mit 12-48 Punkt (Standard: 24 pt)
• Vergrößerung: Lupe mit 1.5× bis 5× (Standard: 2.0×)
• Undo: Letzten Schritt rückgängig
• Redo: Schritt wiederholen

• Strg + Mausrad hoch: Hineinzoomen
• Strg + Mausrad runter: Herauszoomen
• Zoom-Level wird im Fenstertitel angezeigt (z.B. „150%“)
• Bereich: 10% bis 1000%

• Speichern-Button: Öffnet Dateidialog, speichert als PNG
  • Vorgeschlagener Name: screenshot_YYYYMMDD_HHMMSS.png
  • Nur PNG-Format unterstützt
• Zwischenablage-Button: Kopiert Bild direkt in Zwischenablage
  • Kann dann in andere Programme eingefügt werden (Strg+V)
• Beenden-Button: Schließt Programm komplett
  • Warnung bei ungespeicherten Änderungen

Das Tool erkennt automatisch alle angeschlossenen Monitore:

• Berechnet Gesamtfläche über alle Monitore
• Zeigt Monitor-Nummer während der Auswahl
• Berücksichtigt Monitor-Offsets (z.B. bei versetzten Bildschirmen)
• Funktioniert mit erweiterten und gespiegelten Displays

Bei Problemen mit Wayland:

• Automatischer Fallback auf alternative Screenshot-Methode
• Erfasst zunächst gesamten Bildschirm
• Extrahiert dann ausgewählten Bereich

Der Marker ist speziell für Texthervorhebungen:

• 3× breitere Linie als normale Linien
• 40% Deckkraft für „Textmarker-Effekt“
• Verwendete Farbe wird halbtransparent dargestellt

# Abhängigkeiten installieren (Debian/Ubuntu)
sudo apt install python3 python3-gi gir1.2-gtk-3.0 gir1.2-gdk-3.0
 
# Abhängigkeiten installieren (Arch Linux)
sudo pacman -S python gtk3 python-gobject
 
# Skript ausführbar machen
chmod +x guideos-screenshot-editor
 
# Optional: In Systempfad verschieben
sudo mv guideos-screenshot-editor /usr/local/bin/

Das Tool sucht Icons in /usr/share/pixmaps/:

Falls Icons fehlen, verwendet das Tool System-Fallback-Icons.

• Tutorials: Screenshots mit Pfeilen und Text-Anmerkungen
• Bug-Reports: Fehler markieren und beschreiben
• Dokumentation: Benutzeroberflächen annotieren
• Support: Probleme visuell erklären
• Präsentationen: Screenshots mit Hervorhebungen
• Anleitungen: Schritt-für-Schritt mit nummerierten Markierungen