Bumblebee-CP

Color Picker & Palette Manager für Linux Kubuntu(u. andere) / Wayland · KDE Plasma

v2.2.0 · Juli 2026

Picker

Palette

Adjust

Contrast

Table Manager

↓ Download Bumblebee-CP-2.2.0-x86_64.AppImage.zip

AppImage · x86_64 · Python, Tcl/Tk und Pillow enthalten · Linux / Wayland · MIT-Lizenz
MD5: 9c988da8906d180a8ed4a9796afda3b5Python source code: bumblebee-cp_2.2.0_sourcecode.zip

English Summary

Bumblebee-CP is a free color picker and palette manager for Linux systems with Wayland support — built for KDE Plasma. It organizes colors in tables of 13 slots, each with an editable note, and offers five working modes.

Five modes: Picker grabs colors from anywhere on screen via a pixel-perfect zoom loupe (Wayland screen capture through the desktop portal, with four further fallbacks), with an optional timed picker (1–60 s countdown) for hover-only targets; Palette generates harmonious variants from a base color; Adjust tweaks brightness, saturation and temperature (handy for shadow / sun correction on photos); Contrast tests color pairs for WCAG 2.2 compliance with a live AA/AAA verdict; and the Table Manager handles multiple .b-cp table files across projects, including GIMP palette (.gpl) import and export.
Drag & drop reorders slots and drops palette or adjusted swatches onto any slot. Tested on Kubuntu / KDE Plasma 6.

New in 2.2.0: Screen capture no longer depends on a single tool. Five backends are tried in order — spectacle-cli, the XDG desktop portal, KWin D-Bus, grim and Spectacle as a legacy fallback — and the one that worked is remembered for the next pick. The portal is the default: it needs no special permission, answers in a fraction of a second and leaves an open Spectacle window alone. Inside the AppImage the portal runs on the bundled pure-Python D-Bus library jeepney, so the first pick is fast there too. If every backend fails, a dialog lists each one with the reason and a copyable fix command. The About dialog was rebuilt with a proper layout and copy buttons.

Since 2.1.0: Bumblebee-CP ships as an AppImage that bundles Python, Tcl/Tk and Pillow — nothing has to be installed beforehand. Make it executable and run it. On start the AppImage checks whether it is registered in the system and offers to set itself up: it copies itself to ~/Applications/bumblebee-cp/, creates a launcher and adds a menu entry. Declining simply starts the program. --install, --update and --uninstall do the same explicitly, and --help, --version and --licenses round out the command line.

Überblick

Bumblebee-CP ist ein Color Picker und Palette Manager für Linux-Systeme mit Wayland-Unterstützung, ausgelegt auf KDE Plasma. Farben werden in Tabellen mit je 13 Slots organisiert — jeder Slot hat ein editierbares Notizfeld, das mit der Tabellen-Datei gespeichert wird.
Mit Claude.AI ist der Python-Code unter der Linux Distri Kubuntu entstanden.

Unter Wayland läuft die Bildschirm-Aufnahme seit 2.2.0 über eine Kette aus fünf Wegen: spectacle-cli, XDG-Desktop-Portal, KWin-D-Bus, grim und Spectacle als Rückfalloption. Der erste funktionierende Weg wird für den nächsten Griff gemerkt. Die Farbaufnahme erfolgt über eine pixelgenaue Zoom-Lupe. Das dunkle Design fügt sich unauffällig in moderne Desktop-Umgebungen ein.

Farbtabellen sind eigenständige Dateien, die überall auf der Platte liegen können (typischerweise im Projektordner). Eine zentrale Registry unter ~/.config/bumblebee-cp/settings.json führt alle bekannten Tabellen über ihren vollständigen Pfad. Neue Tabellen erhalten die Endung .b-cp; ältere .json-Dateien bleiben lesbar (automatische Migration).

Features

🎯Picker

Farben überall vom Bildschirm aufnehmen — über eine pixelgenaue Zoom-Lupe (17 px, 8× Zoom) mit rotem Fadenkreuz. Wayland-Aufnahme über das Desktop-Portal.

⏱Timed Picker

Pick⏱ mit konfigurierbarem Countdown-OSD (1–60 s), um zu Hover-only-Zielen wie Tooltips oder Menüs zu navigieren. Rechtsklick öffnet den Sekunden-Slider.

🎨Palette

Harmonische Farbvarianten aus einer Basisfarbe erzeugen. Varianten lassen sich per Drag & Drop direkt auf einen Slot ziehen.

🔆Adjust

Helligkeit, Sättigung und Farbtemperatur feinjustieren — praktisch für Schatten- und Sonnen-Korrektur an Fotos. Der „Adjusted"-Swatch ist auf jeden Slot ziehbar.

⬛Contrast (WCAG 2.2)

Farbpaare auf Kontrast nach WCAG 2.2 prüfen: Drag & Drop zweier Slot-Farben, Live-Vorschau und AA/AAA-Bewertung mit dem Kontrastverhältnis.

🗂Table Manager

Mehrere .b-cp-Tabellen projektübergreifend verwalten: neu / öffnen / „Speichern unter" / duplizieren / löschen / wechseln. Datei und Verzeichnis nebeneinander.

🐝GIMP-Paletten

GIMP-Paletten (.gpl) im Table Manager importieren und exportieren — Austausch mit GIMP, Inkscape und Co.

↕Drag & Drop

Slots per Drag & Drop umsortieren (Tausch). Palette- und Adjusted-Swatches direkt auf Ziel-Slots ablegen. 13 Slots passen ohne Scrollen.

📦AppImage

Python, Tcl/Tk und Pillow sind im AppImage enthalten — keine Systempakete vorab nötig. Herunterladen, ausführbar machen, starten.

⚙Selbst-Einrichtung

Beim Start prüft das AppImage, ob es im System registriert ist, und bietet Installation, Update oder Downgrade an. Ablehnen startet einfach das Programm.

⌨Kommandozeile

--help, --version, --licenses sowie --install, --update und --uninstall.

📄Lizenz-Links

Der About-Dialog öffnet LICENSE und THIRD-PARTY-LICENSES.md direkt im Standard-Editor.

📸Fünf Aufnahme-Wege neu in 2.2.0

spectacle-cli → Desktop-Portal → KWin-D-Bus → grim → Spectacle. Der erste funktionierende Weg wird gemerkt. Ein offenes Spectacle-Fenster bleibt offen.

🩺Diagnose-Dialog neu in 2.2.0

Scheitern alle Wege, zeigt ein Dialog jeden Weg mit Grund — und den passenden Befehl zum Kopieren per Klick.

Die fünf Modi

Modus	Funktion
Picker	Farben vom Bildschirm aufnehmen — Zoom-Lupe mit Fadenkreuz, Wayland-Aufnahme über Desktop-Portal (mit vier Fallback-Wegen)
Palette	Harmonische Farbvarianten aus einer Basisfarbe generieren
Adjust	Helligkeit / Sättigung / Farbtemperatur anpassen (Schatten- / Sonnen-Korrektur)
Contrast	Farbpaare auf WCAG-2.2-Kontrast prüfen — Ratio + AA/AAA-Bewertung
Table Manager	Mehrere Farbtabellen über Projekte hinweg verwalten; GIMP-Palette-Import/-Export

Die Tabelle

Jede Tabelle hat 13 Slots — das passt ohne Scrollen auf den Bildschirm. Die Spalten:

Spalte	Bedeutung
#	Slot-Nummer (1–13)
Color	Farb-Swatch — Drag & Drop zum Umsortieren
Hex	Hex-Wert der Farbe (z. B. `#e87020`)
Note	Frei editierbares Notizfeld, wird mit der Tabelle gespeichert
Pick	Farbe sofort vom Bildschirm aufnehmen
Pick⏱	Farbe mit Countdown aufnehmen; Rechtsklick öffnet den Sekunden-Slider (1–60 s)
Copy	Hex-Wert in die Zwischenablage kopieren
Trash	Slot leeren

Dateiformate

Endung	Beschreibung
`.b-cp`	Native Bumblebee-CP-Farbtabelle (JSON-basiert)
`.json`	Legacy-Format (weiterhin lesbar, automatisch migriert)
`.gpl`	GIMP-Palette (Import / Export im Table Manager)

Installation

Voraussetzungen

Komponente	Details
Betriebssystem	Linux mit Wayland (entwickelt unter Kubuntu 26.04 / KDE Plasma 6) auf AMD und intel Ein Schnelltest mit Ubuntu-26.04.4-desktop-amd64, linuxmint-22.3-cinnamon-64bit und TUXEDO-OS-202604211002 war positiv.
Bildschirm-Aufnahme	Auf einem Wayland-Desktop mit XDG-Desktop-Portal ist nichts weiter nötig — das Portal ist der Standardweg. Optional erweitern `kde-spectacle` (KDE) und `grim` (Sway / Hyprland) die Kette. Diese Werkzeuge werden vom Zielsystem aufgerufen und sind nicht im AppImage enthalten.
python3-dbus, python3-gi optional	Beschleunigen den Portal- und KWin-Weg — nur beim direkten Skript-Start; im AppImage übernimmt das gebündelte `jeepney` diese Aufgabe. Fehlen sie, weicht das Programm auf `gdbus` aus.
Python	3.10+ — nur beim direkten Skript-Start; im AppImage enthalten
python3-tk	GUI-Framework (tkinter) — nur beim direkten Skript-Start; im AppImage enthalten
python3-pil	Bildverarbeitung (Pillow) inkl. `python3-pil.imagetk` — nur beim direkten Skript-Start; im AppImage enthalten

AppImage (empfohlen)

Das AppImage bringt Python, Tcl/Tk und Pillow mit — es muss vorab nichts installiert werden.

chmod +x Bumblebee-CP-2.2.0-x86_64.AppImage
./Bumblebee-CP-2.2.0-x86_64.AppImage

Beim Start prüft das AppImage, ob es bereits im System registriert ist. Falls nicht, fragt es nach: Bei Zustimmung kopiert es sich nach ~/Applications/bumblebee-cp/, legt einen Launcher unter ~/.local/bin/bumblebee-cp an und erstellt einen Menü-Eintrag. Bei Ablehnung startet das Programm ganz normal — die Frage kommt beim nächsten Mal wieder. Die bereits installierte Kopie fragt nie.

Ist eine andere Version eingerichtet, erkennt Bumblebee-CP das und bietet passend ein Update an; bei einer älteren Datei wird vor dem Downgrade nachgefragt. Beide Versionsnummern stehen im Dialog.

Diese Schritte lassen sich auch direkt auslösen:

./Bumblebee-CP-2.2.0-x86_64.AppImage --install
./Bumblebee-CP-2.2.0-x86_64.AppImage --update
./Bumblebee-CP-2.2.0-x86_64.AppImage --uninstall

Danach Start über das Anwendungsmenü („Bumblebee-CP") oder im Terminal:

bumblebee-cp

Wird der Terminal-Befehl nicht gefunden, sicherstellen, dass ~/.local/bin im PATH liegt (der Menü-Eintrag funktioniert unabhängig davon):

export PATH="$HOME/.local/bin:$PATH"

Skript direkt starten

Für den direkten Start des Python-Skripts werden die Systempakete benötigt:

sudo apt install python3-tk python3-pil python3-pil.imagetk

# optional, macht den Portal-Weg schneller:
sudo apt install python3-dbus python3-gi

tar xzf bumblebee-cp_2.2.0.tar.gz
cd bumblebee-cp-2.2.0
python3 bumblebee_cp_2_2_0.py

Die PNG-Assets müssen dabei im Unterordner assets_bumblebee-cp/ direkt neben der Programmdatei liegen.

Kommandozeilen-Optionen

Option	Wirkung
`--help`, `-h`	Hilfe anzeigen und beenden
`--version`, `-V`	Version anzeigen und beenden
`--licenses`	Lizenz-Dateien im Standard-Editor öffnen
`--install`	Dieses AppImage im System-Menü registrieren
`--update`	Installierte Version durch dieses AppImage ersetzen
`--uninstall`	Frühere Installation entfernen

Die Integrations-Optionen wirken nur beim Start als AppImage.

Wo was installiert wird

Element	Ort
Programm	`~/Applications/bumblebee-cp/Bumblebee-CP.AppImage`
Icon	`~/Applications/bumblebee-cp/bumblebee-cp.png`
Versions-Marker	`~/Applications/bumblebee-cp/.version`
Launcher-Befehl	`~/.local/bin/bumblebee-cp`
Menü-Eintrag	`~/.local/share/applications/bumblebee-cp.desktop`
Einstellungen + Tabellen-Registry	`~/.config/bumblebee-cp/settings.json`

Deinstallation

./Bumblebee-CP-2.2.0-x86_64.AppImage --uninstall

Das entfernt den Programmordner, den Launcher und den Menü-Eintrag.

Manuelle Deinstallation

rm -rf ~/Applications/bumblebee-cp
rm -f ~/.local/bin/bumblebee-cp
rm -f ~/.local/share/applications/bumblebee-cp.desktop

Das Konfigurationsverzeichnis wird nicht automatisch entfernt. Um es ebenfalls zu löschen:

rm -rf ~/.config/bumblebee-cp

Wer eine ältere Version noch auf dem alten Weg installiert hat, kann sie mit dem damaligen uninstall.sh entfernen. Das neue AppImage richtet sich unabhängig davon ein.

Änderungen in 2.2.0

28. Juli 2026

Zwei Themen in einem Release: Die Bildschirmaufnahme hängt nicht mehr an einem einzigen Werkzeug, und der About-Dialog wurde um ein sauberes Layout herum neu gebaut.

Neu

Bildschirmaufnahme über fünf Wege — der Reihe nach spectacle-cli, XDG-Desktop-Portal (org.freedesktop.portal.Screenshot), KWin-D-Bus (org.kde.KWin.ScreenShot2), grim und Spectacle als Rückfalloption. Der Weg, der funktioniert hat, wird für den nächsten Griff gemerkt.
Portal-Weg im AppImage — über die gebündelte reine-Python-D-Bus-Bibliothek jeepney. Damit ist auch im AppImage schon der erste Griff schnell.
Fehler-Dialog bei misslungener Aufnahme — listet jeden Weg mit dem Grund des Scheiterns auf; jeder Lösungsvorschlag steht als ein kopierbarer Befehl mit Copy-Button daneben.
X-KDE-DBUS-Restricted-Interfaces im Menü-Eintrag — KWin gibt die Bildschirmaufnahme nur für Programme frei, die die Schnittstelle deklarieren; die Zeile schreibt jetzt setup-system.sh.
Kopierbare Befehlszeilen und Tooltips im About-Dialog; Escape und Return schließen ihn.

Geändert

About-Dialog neu aufgebaut — Bild links, Textspalte rechts, gemeinsame linke Textkante; das Fenster bemisst sich nach seinem Inhalt und zentriert sich über dem Hauptfenster.
kde-spectacle ist keine harte Voraussetzung mehr — einer der fünf Wege genügt.
Lizenz-Links unterstreichen erst beim Überfahren.

Behoben

Ein offenes Spectacle-Fenster wird von einer Farbaufnahme nicht mehr geschlossen. Der Rückfallweg über Spectacle wird übersprungen, solange eine Spectacle-Instanz läuft.
Schnelle Aufnahme im AppImage. Zuvor fiel die Kette dort bis auf Spectacle durch, dessen Qt-Start beim ersten Griff rund 9 Sekunden kostete.
Die Aufnahme läuft in einem Arbeits-Thread — die Oberfläche friert nicht mehr ein; hängende Portal- und KWin-Aufrufe laufen jetzt in eine echte Zeitgrenze.
grim wird unter KWin nicht mehr versucht (das benötigte wlr-screencopy gibt es dort nicht).

Änderungen in 2.1.0

22. Juli 2026

2.1.0 bringt keine neue Farb-Funktion. In diesem Release geht es darum, dass zwischen Download und der ersten aufgenommenen Farbe nichts mehr im Weg steht.

Neu

AppImage-Distribution — bündelt Python, Tcl/Tk und Pillow; keine Systempakete vorab nötig.
Desktop-Integration aus dem AppImage heraus — --install, --update (mit Versionsvergleich) und --uninstall. Die Benutzer-Konfiguration bleibt beim Deinstallieren erhalten.
Setup-Prüfung beim Start — das normal gestartete AppImage prüft, ob es im System registriert ist, und bietet Installation, Update oder Downgrade an. Ablehnen startet einfach das Programm; die installierte Kopie fragt nie.
Kommandozeilen-Optionen — --help / -h, --version / -V und --licenses.
Lizenz-Links im About-Dialog — zwei anklickbare Zeilen über dem OK-Button öffnen LICENSE und THIRD-PARTY-LICENSES.md, jeweils mit Tooltip.
Drittanbieter-Lizenzdokumentation (THIRD-PARTY-LICENSES.md) für die im AppImage gebündelten Komponenten.

Geändert

Der About-Dialog ist etwas höher, damit die Lizenz-Links hineinpassen.
LICENSE nennt jetzt die Kennzeichen-Ausnahme für Logo und Hummel-Figur und stellt die übrigen Oberflächen-Icons unter CC BY-SA 4.0.
README rund um das AppImage als primären Installationsweg neu geschrieben.

Hinweise

Die externen Werkzeuge für Bildschirmaufnahme und Monitor-Erkennung (spectacle, spectacle-cli, grim, gdbus, xrandr, kscreen-doctor) sind nicht gebündelt — sie werden vom Zielsystem aufgerufen und behalten ihre eigenen Lizenzen.
Der direkte Start des Python-Skripts benötigt weiterhin python3-tk, python3-pil und python3-pil.imagetk.

Technische Details

Eigenschaft	Wert
Version	2.2.0 (Semantic Versioning)
Sprache	Python 3.10+
GUI-Framework	tkinter + Pillow (PIL)
Distribution	AppImage (x86_64) mit gebündeltem Python, Tcl/Tk und Pillow; alternativ Python-Skript aus dem Quell-Archiv
Screenshot-Backends	Kette aus fünf Wegen: `spectacle-cli` → XDG-Desktop-Portal → KWin-D-Bus → `grim` → Spectacle (Rückfall). Im AppImage über das gebündelte `jeepney`.
Slots pro Tabelle	13 (ohne Scrollen sichtbar)
Lupe	17 px Ausschnitt, 8× Zoom, pixelgenau mit Fadenkreuz
Kontrast-Test	WCAG 2.2, AA/AAA-Bewertung mit Live-Vorschau
Dateiformate	`.b-cp` (nativ), `.json` (Legacy), `.gpl` (GIMP-Import/-Export)
Konfiguration	JSON (Einstellungen + globale Tabellen-Registry)
Lizenz	MIT-Lizenz für den Programmcode. Du darfst die Software kostenlos benutzen, kopieren, ändern, weitergeben und verkaufen. Ich gebe keine Garantie und hafte nicht für Schäden oder Probleme. You may use, copy, modify, share, and sell the software for free. I provide no warranty and am not liable for any damages or problems. Die Oberflächen-Icons stehen unter CC BY-SA 4.0. Logo und Hummel-Figur sind als Kennzeichen von Bekudio davon ausgenommen — bei einer veränderten Version bitte durch eigene Grafik ersetzen. Das AppImage bündelt Python, Tcl/Tk, Pillow und jeepney unter deren eigenen Lizenzen (siehe `THIRD-PARTY-LICENSES.md`). Die externen Werkzeuge `spectacle`, `spectacle-cli`, `grim`, `gdbus`, `xrandr` und `kscreen-doctor` werden nicht mitverteilt, sondern vom Zielsystem aufgerufen. Beide Lizenz-Dokumente sind auch aus dem About-Dialog heraus erreichbar.