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