Dies ist eine alte Version des Dokuments!

GuideOS Bildschirmfoto-Editor

Übersicht

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

Zweck

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.

Hauptfunktionen

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

Bedienung

Programm starten

guideos-screenshot-editor

Oder aus dem Anwendungsmenü starten.

Screenshot erstellen

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

Editor-Werkzeuge

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

Werkzeug	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

Einstellungen

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

Zoom-Funktion

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

Speichern und Export

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

Tastenkürzel

Taste	Funktion
ESC	Bereichsauswahl abbrechen
Enter / Space	Auswahl bestätigen
Strg + Mausrad	Zoom im Editor

Wichtige Hinweise

Multi-Monitor: Bei mehreren Bildschirmen automatische Monitor-Erkennung
Marker-Tool: Erzeugt halbtransparente Markierungen (40% Deckkraft)
Lupe: Zeigt vergrößerten Bereich - wird nicht als Annotation gespeichert
Wayland: Automatischer Fallback bei Problemen mit Wayland-Compositor
Zoom: Beeinflusst nur die Anzeige, nicht die gespeicherte Bildgröße
Zwischenablage: Bild enthält alle Annotationen
Beenden-Button: Schließt Programm vollständig (nicht nur Editor-Fenster)

Funktionsweise

Multi-Monitor-Unterstützung

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

Wayland-Fallback

Bei Problemen mit Wayland:

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

Marker-Werkzeug

Der Marker ist speziell für Texthervorhebungen:

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

Installation

# Abhängigkeiten werden mit installiert
sudo apt install guideos-screenshot-editor

Benötigte Icons

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

Icon-Datei	Werkzeug
`Linie.png`	Linien-Tool
`Quadrat.png` / `Rechteck.png`	Rechteck-Tool
`Kreis.png`	Kreis-Tool
`Pfeil.png`	Pfeil-Tool
`Text.png` / `T.png` / `A.png`	Text-Tool
`Marker.png`	Marker-Tool
`Lupe.png`	Lupen-Tool
`zurueck.png` / `undo.png`	Undo-Button
`vor.png` / `redo.png`	Redo-Button

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

Anwendungsbeispiele

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

Lizenz

Autor	evilware666
Lizenz	MIT

Inhaltsverzeichnis