🌙 KeePass-DarkMode

Dunkles Theme für KeePass 2.x — augenfreundlich, auch nachts.
Kein Umstieg, kein Funktionsverlust: Alles bleibt, nur die Optik ändert sich.

---

Inhalt

• Screenshots
• Quick Start
• Installation
• Features
• Eigene Themes
• Troubleshooting
• Kompatibilität
• Entwicklung

---

📸 Screenshots

Hauptfenster im Dark Mode	Bearbeiten-Dialog

Tools-Menü mit Dark-Theme-Schalter	Optionen (Reiter KeePass-DarkMode)

Theme-Konfiguration mit Live-Vorschau

---

⚡ Quick Start

STRG + T          Theme umschalten

Alternativ über das Menü: Tools → Dark Theme (der Menüpunkt trägt den Namen des gewählten Themes)

---

🚀 Installation

1. KeePassDarkMode.plgx von der Release-Seite herunterladen

2. In den Plugin-Ordner kopieren — je nach KeePass-Version:

   Version	Pfad
   KeePass Standard	C:\Program Files\KeePass Password Safe 2\Plugins\
   KeePass Standard (ältere 32-Bit-Installation)	C:\Program Files (x86)\KeePass Password Safe 2\Plugins\
   Pleasant PPS	C:\Program Files (x86)\Pleasant Solutions\KeePass for Pleasant Password Server\Plugins\

3. KeePass neu starten — fertig.

Tip

Den Plugin-Ordner öffnet Tools → Plugins → Open Folder direkt. KeePass lädt Plugins nur beim Start — nach dem Kopieren ist ein Neustart nötig.

---

✨ Features

🌑 Dunkles Theme	Ruhige, moderne Farbpalette für die gesamte KeePass-Oberfläche
🎨 Fünf Themes	Standard, Windows 11, Dracula, Colorblind und High Contrast — per Dropdown wechselbar
⌨️ Hotkey	STRG+T zum Umschalten — frei konfigurierbar
🖌️ Theme-Editor	Eigene Farbwelten per GUI erstellen, ohne Textdateien zu editieren
📦 Plgx-Format	Ein Dateisprung installiert/updatet das Plugin — ohne Kompilieren
🔧 Theme-Erkennung	Folgt dem Windows-Farbschema — im Dunkel-Modus aktiv, im Hell-Modus aus
🎨 Windows-Akzent	optional: übernimmt die Windows-Akzentfarbe für Highlights
🔔 Update-Hinweis	zeigt eine neue Version direkt im Menü unter Tools an
🪟 Flackerfrei	Dialoge und Textfelder werden dunkel aufgebaut, bevor sie das erste Mal malen
🖥️ Native Dialoge	Message-Boxen und Fenster bekommen eine dunkle Titelzeile

---

🎨 Eigene Themes

Mit dem eingebauten Theme-Editor erstellst du im Handumdrehen eigene Farbwelten:

Eigene Theme-Dateien (.ini) einfach in den Plugin-Ordner legen — sie erscheinen automatisch in der Auswahl unter Tools → Optionen → KeePass-DarkMode.

Fünf mitgelieferte Themes liegen bei:

Theme	Beschreibung
DarkTheme.ini	Klassisches dunkles Theme (Standard)
DarkThemeWin11.ini	An Windows-11-Optik angepasst
DarkThemeDracula.ini	Nach der Dracula-Palette
DarkThemeColorblind.ini	Für Farbfehlsichtigkeit optimierte Kontraste
DarkThemeHighContrast.ini	Hoher Kontrast für barrierefreies Sehen

---

🔧 Troubleshooting

Plugin-Cache leeren

Nach einem Update kann ein veralteter Plugin-Cache für Lade-Probleme sorgen. Dazu einfach %LOCALAPPDATA%\KeePass\PluginCache\ (bei Pleasant PPS: %LOCALAPPDATA%\PleasantKeePass\PluginCache\) löschen und KeePass neu starten.

Bestimmte Bereiche bleiben hell

KeePass nutzt klassische Windows-Controls, die sich nur eingeschränkt umfärben lassen. Einzelne Stellen (z. B. bestimmte Dialoge und Systemmenüs) können hell bleiben — alltagstauglich, aber kein kompromissloses Pixel-Perfect-Theming.

---

🧩 Kompatibilität

• KeePass: 2.4x und neuer (gegen 2.42 gebaut, lauffähig mit aktuellen Versionen)
• Windows: 10 und 11
• .NET Framework: 4.5 oder neuer

---

🛠️ Entwicklung

# Build unter Windows (benötigt .NET Framework 4.5)
msbuild KeePass-DarkMode.sln /p:Configuration=Release

# plgx-Paket erzeugen
cd build && build.cmd

Gebaut wird unter Windows mit MSBuild (.NET Framework 4.5) — GitHub Actions sind deaktiviert, die Builds laufen lokal bzw. auf einer separaten Build-Maschine.

Wichtig beim plgx-Bauen: KeePass übernimmt den BaseFileName aus <AssemblyName> der .csproj und erwartet daraus abgeleitet die Plugin-Klasse <AssemblyName>.<AssemblyName>Ext. Dateiname, Assembly-Name und Klassenname müssen übereinstimmen.