No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-12 16:40:56 +02:00
.agents Add requirements.txt, README.md, and workspace rules 2026-07-12 13:53:18 +02:00
.gitignore Initial commit - Clipboard Manager 2026-07-12 13:47:18 +02:00
config.py Initial commit - Clipboard Manager 2026-07-12 13:47:18 +02:00
gui.py Fix hover_color transparency ValueError for CTkButton inside BildKarte 2026-07-12 16:40:56 +02:00
hotkey.py Initial commit - Clipboard Manager 2026-07-12 13:47:18 +02:00
main.py Initial commit - Clipboard Manager 2026-07-12 13:47:18 +02:00
monitor.py Implement clipboard image support, thumbnails, and automatic cleanup 2026-07-12 16:34:42 +02:00
README.md Add requirements.txt, README.md, and workspace rules 2026-07-12 13:53:18 +02:00
requirements.txt Add requirements.txt, README.md, and workspace rules 2026-07-12 13:53:18 +02:00
storage.py Implement clipboard image support, thumbnails, and automatic cleanup 2026-07-12 16:34:42 +02:00
test_alles.py Implement clipboard image support, thumbnails, and automatic cleanup 2026-07-12 16:34:42 +02:00
tray.py Initial commit - Clipboard Manager 2026-07-12 13:47:18 +02:00

📋 Windows Zwischenablage-Manager

Ein moderner, extrem schneller und ressourcenschonender Zwischenablage-Manager für Windows. Das Programm läuft unauffällig im Hintergrund, zeichnet den Verlauf Ihrer kopierten Texte auf und ermöglicht es Ihnen, diese per globalem Tastatur-Shortcut (Strg+Alt+V) direkt an Ihrer Mausposition aufzurufen und direkt in die aktive Anwendung einzufügen.


🌟 Features

  • ⚡ Globaler Hotkey (Strg+Alt+V): Blendet das Manager-Fenster blitzschnell direkt am Mauszeiger ein oder aus.
  • ✨ Direktes Einfügen: Klicken Sie einfach auf eine Textkarte im Verlauf oder in den Favoriten – das Fenster schließt sich und der Text wird automatisch an der Cursor-Position eingefügt (Strg+V Simulation).
  • ⭐ Dauerhafte Favoriten: Fügen Sie wichtige Texte durch Klick auf das Stern-Symbol (☆ / ★) zu Ihren Favoriten hinzu. Diese bleiben dauerhaft gespeichert.
  • ☁️ OneDrive-Synchronisation: Der Speicherort für die Favoriten-Datei ist frei wählbar. Wählen Sie einfach einen OneDrive-Ordner, um Ihre Favoriten automatisch und konfliktfrei über mehrere Rechner hinweg zu synchronisieren.
  • 🛡️ Atomsicheres Speichern: Dateischreibvorgänge laufen über temporäre Dateien mit automatischer Retry-Logik. Dies verhindert Datenverluste, falls OneDrive die Datei während eines Abgleichs sperrt.
  • 🎨 Premium-Design: Hochmodernes Design mit CustomTkinter. Unterstützt Hell, Dunkel und System-Modus (passt sich Windows an). Ein feiner roter Rand sorgt dafür, dass das rahmenlose Fenster auf jedem Hintergrund sofort erkennbar ist.
  • 🔍 Blitzschnelle Suche: Filtern Sie den Verlauf oder Ihre Favoriten in Echtzeit über die obere Suchleiste.
  • 📥 System-Tray Integration: Die App minimiert sich unauffällig in den System-Tray (Taskleiste unten rechts) und blockiert keine Fenster in der Taskleiste.

🎹 Bedienung & Shortcuts

  • Strg+Alt+V: Fenster einblenden / ausblenden.
  • Mausklick auf Textkarte: Fügt den Text direkt in die aktive App ein und blendet das Fenster aus.
  • — (Minimieren-Button): Versteckt das Fenster im Hintergrund.
  • ✕ (Schließen-Button): Versteckt das Fenster im Hintergrund.
  • ⚙ (Zahnrad-Button): Öffnet das Einstellungsfenster zur Verwaltung des OneDrive-Pfads und des Farbschemas.
  • Beenden (Roter Button): Beendet das Programm und alle Hintergrundprozesse vollständig.

🚀 Installation & Start

Voraussetzungen

  • Betriebssystem: Windows 10 oder Windows 11 (da native Windows-APIs für globale Hotkeys und Tastatursimulation verwendet werden).
  • Python: Version 3.8 oder neuer.

1. Repository klonen

git clone https://github.com/Snakepit81/zwischenablage-manager.git
cd zwischenablage-manager

2. Abhängigkeiten installieren

Installieren Sie die benötigten Pakete über die Kommandozeile:

pip install -r requirements.txt

3. Programm starten

Starten Sie den Manager mit:

python main.py

Tipp: Beim ersten Start öffnet sich automatisch ein Dialog, in dem Sie Ihren bevorzugten Speicherort (z. B. Ihren OneDrive-Ordner) auswählen können.


⚙️ Technische Details & Architektur

  • main.py: Startet das Programm, initialisiert die Threads für Hotkeys und System-Tray und koordiniert die Event-Loops.
  • gui.py: Baut das Hauptfenster, das Einstellungsfenster sowie die Kacheln auf. Enthält die Drag-Eventhandler für die eigene Titelleiste.
  • monitor.py: Pollt die Windows-Zwischenablage alle 200 ms. Filtert Duplikate und simuliert den Einfügevorgang via Win32-API.
  • hotkey.py: Thread, der mittels nativer Windows-APIs (RegisterHotKey) systemweit auf die Tastenkombination lauscht.
  • storage.py: Kapselt die Dateizugriffe auf favoriten.json mit atomsicherer Ersatzlogik.
  • config.py: Verwaltet die Konfiguration (einstellungen.json im AppData-Verzeichnis) und die globalen Farb-Tokens.
  • tray.py: Verwaltet das Taskleistensymbol und das zugehörige Rechtsklick-Kontextmenü.