Mouse – Maussteuerung mit Python

Einleitung

Die Maussteuerung ist ein zentraler Bestandteil der Automatisierung von Benutzeroberflächen. Ob für automatisierte Tests, Skripte, Spiel-Bots oder RPA-Tools – oft ist es nötig, den Mauszeiger programmatisch zu bewegen, Klicks zu simulieren oder Benutzereingaben aufzuzeichnen. In Python eignet sich dafür hervorragend die Bibliothek mouse.

Die Bibliothek mouse bietet eine einfache und direkte API für die Maussteuerung: Ereignisverfolgung, Klick-Ausführung sowie Aufzeichnung und Wiedergabe von Bewegungen. Sie ist plattformübergreifend, leicht zu installieren und wird sowohl in einfachen Skripten als auch in komplexen RPA-Projekten eingesetzt.

Installation und Einrichtung der mouse-Bibliothek

Installation mit pip

pip install mouse

Systemvoraussetzungen und Berechtigungen

Unter Linux und macOS kann es erforderlich sein, das Skript mit Administratorrechten auszuführen oder entsprechende Berechtigungen für die Eingabesteuerung zu erteilen.

Für Linux:

sudo pip install mouse

Für macOS: Gehe zu Systemeinstellungen → Sicherheit & Datenschutz → Bedienungshilfen und erlaube den Zugriff für dein Terminal oder die IDE.

Für Windows: Einige Funktionen erfordern Administratorrechte. Starte dein Skript oder die Konsole als Administrator.

Architektur und Funktionsweise

Wichtige Komponenten

Die Bibliothek mouse besteht aus mehreren Kernkomponenten:

• Controller – Steuerung des Mauszeigers und Simulation von Aktionen
• Listener – Überwachung von Mausereignissen
• Recorder – Aufzeichnung und Wiedergabe von Makros
• Event System – Ereignisverarbeitungssystem

Unterstützte Plattformen

• Windows (über Windows API)
• macOS (über Cocoa)
• Linux (über X11/Wayland)

Hauptfunktionen der Bibliothek

Simulation von Mausaktionen

Die mouse-Bibliothek fungiert sowohl als Listener (Erfassung von Benutzeraktionen) als auch als Controller (Simulation von Bewegungen und Klicks).

Wichtige Funktionen:

• Überwachung von Tastendrücken und Loslassen
• Ermittlung der Mausposition
• Programmatische Klicks und Scrollen
• Bewegen des Mauszeigers
• Maus-Hotkeys
• Aufzeichnung und Wiedergabe von Makros

Ereignistypen

Die Bibliothek verarbeitet folgende Ereignisse:

• ButtonEvent – Drücken/Loslassen einer Maustaste
• MoveEvent – Bewegung des Mauszeigers
• WheelEvent – Scrollen des Mausrads

Mauszeiger steuern und positionieren

Mauszeiger bewegen

import mouse

# Absolute Positionierung
mouse.move(100, 200)

# Relative Bewegung
mouse.move(50, 0, absolute=False)

# Sanfte Bewegung mit Verzögerung
mouse.move(300, 400, duration=1.0)

Aktuelle Koordinaten abrufen

# Mausposition abrufen
x, y = mouse.get_position()
print(f"Mauszeiger ist bei: ({x}, {y})")

# In Bedingungen verwenden
if mouse.get_position()[0] > 500:
    print("Mauszeiger ist im rechten Bildschirmbereich")

Klicks und Aktionen simulieren

Wichtige Klickarten

# Linksklick
mouse.click('left')
mouse.left_click()

# Rechtsklick
mouse.click('right')
mouse.right_click()

# Mittelklick
mouse.click('middle')
mouse.middle_click()

# Doppelklick
mouse.double_click()

Klicks auf bestimmte Koordinaten

# Klick auf bestimmte Koordinaten
mouse.click('left', (300, 400))

# Position vor dem Klick speichern
original_pos = mouse.get_position()
mouse.click('left', (100, 100))
mouse.move(*original_pos)

Maustaste gedrückt halten