Merge development branch

Author: Valer100

README.md

@@ -32,7 +32,21 @@ print(winaccent.accent_light) # Prints the light mode accent color
 
 ### Update accent colors
 
-The accent colors can be updated using the ```update_accent_colors()``` function. This function will retrieve the values again.
+The accent colors can be updated manually using the ```update_accent_colors()``` function. This function will retrieve the values again.
+
+### Accent color change listener
+This module allows you to add a listener that will call a specific function when the accent color changes. Here's how you can add it:
+
+```python
+import winaccent, threading
+
+# Replace `callback` with the function that you want to be called
+thread = threading.Thread(target = lambda: winaccent.on_accent_changed_listener(callback), daemon = True)
+thread.start()
+```
+
+> [!NOTE]
+> If you added the listener, there's no need to call `update_accent_colors` because it will be called automatically every time the accent color changes.
 
 ## 🖥️ Output
 Here is the output for the default (blue) accent color on Windows 11:
@@ -53,4 +67,4 @@ Here is the output for a custom accent color (green):
 | accent_normal | #008B00 | <img src="https://github.com/Valer100/winaccent/blob/main/assets/colors/accent_normal_green.png?raw=true"> |
 
 ## 📋 To do
-- [ ] Add an accent color change listener
+- [x] ~~Add an accent color change listener~~

demo_gui.py

@@ -1,4 +1,4 @@
-import tkinter as tk, winaccent
+import tkinter as tk, winaccent, threading
 from tkinter import ttk
 
 window = tk.Tk()
@@ -24,8 +24,9 @@ def update_accent_colors():
     add_item(winaccent.accent_dark, "Dark mode accent color")
     add_item(winaccent.accent_normal, "Normal accent color")
 
-    ttk.Button(window, text = "Refresh", command = update_accent_colors, default = "active").pack(fill = "x", pady = 8, padx = 5)
-
 update_accent_colors()
 
+thread = threading.Thread(target = lambda: winaccent.on_accent_changed_listener(update_accent_colors), daemon = True)
+thread.start()
+
 window.mainloop()

requirements.txt

@@ -4,7 +4,7 @@
 
 setup(
     name = "winaccent",
-    version = "0.2.0",
+    version = "0.3.0",
     license = "MIT",
     author = "Valer100",
     description = "A simple module for getting Windows' accent color",

setup.py

@@ -2,7 +2,7 @@
 A simple module for getting Windows' accent color. With this module you can get both light and dark mode accent colors.
 '''
 
-import winreg, sys
+import winreg, sys, time
 
 if not sys.platform == "win32" or  not sys.getwindowsversion().major == 10: 
     raise Exception("This module only works on Windows 10 and later!")
@@ -27,4 +27,12 @@ def update_accent_colors():
     dwm = "Software\\Microsoft\\Windows\\DWM"
     accent_normal = f"#{get_registry_value(winreg.HKEY_CURRENT_USER, f'{dwm}', 'ColorizationAfterglow'): X}".replace("# C4", "#")
 
+def on_accent_changed_listener(callback):
+    while True:
+        old_value = accent_normal
+        update_accent_colors()
+
+        if old_value != accent_normal: callback()
+        time.sleep(1)
+
 update_accent_colors()