Skip to content

Changelog

Version 2.1.0 (June 24, 2025)

New features

  • Added 2 flags: get_accent_from_dwm and dark_mode_window
  • Now you can retrieve the active/inactive titlebar text color from the titlebar_active_text and titlebar_inactive_text variables.
  • Now you can retrieve the actual active/inactive titlebar color regardless if the "Show accent color on title bars and window borders" setting is enabled or not.
  • Now you can retrieve the inactive window border color using window_border_inactive. For retrieving the active window border color, use window_border_active. window_border will be deprecated starting with version 3.0.0.
  • Now you can retrieve the start menu and taskbar color using start_menu and taskbar (you can also check if they are colored or not using is_start_menu_colored and is_taskbar_colored booleans).

Improvements

  • Redesigned the GUI demo to look better and cleaner.
  • New documentation website (this one).

Regressions

  • Compatibility with Python 3.6 and 3.7 is broken (will be fixed in the next update).

Version 2.0.1 (October 21, 2024)

Breaking changes

  • The minimum Python version supported was changed to 3.6
  • The module will now raise an ImportError exception instead of an UnsupportedPlatfromException exception
  • on_accent_changed_listener() function was renamed to on_appearance_changed()
  • update_accent_colors() function was renamed to update_values()

New features

  • Added Windows 8.x support
  • Added a function to convert HEX colors to RGB tuples (hex_to_rgb())
  • Retrieve apps' theme and system's theme using apps_use_light_theme and system_uses_light_theme booleans

Fixes

  • Get the right window_border color in Windows 10 and 11
  • Use placeholder values if the registry keys for some values do not exist
  • More optimizations and improvements

What happened to v2.0.0?

Well, that version had a bug that I didn't notice. The system_uses_light_theme boolean was returning the wrong value for the current system theme. This is fixed in v2.0.1.

Version 1.1.0 (September 26, 2024)

What's new

  • Now you can check if the "Show accent color on title bars and window borders" option from Settings > Personalization > Color is enabled using the is_titlebar_colored boolean.
  • New colors added: titlebar_active, titlebar_inactive, window_border and accent_menu.
  • Some demo improvements.

Version 1.0.1 (September 9, 2024)

What's new

  • Raise a winaccent.UnsupportedPlatformException exception when the module is imported on a different OS than Windows and Windows versions older than 10.
  • winreg module won't be imported anymore on platforms other than Windows
  • Now python -m winaccent supports an optional --mode argument.

Version 1.0.0 (September 1, 2024)

Breaking changes

accent_light was renamed to accent_dark and accent_dark to accent_light to reflect the lightness/darkness of the color. This means that after upgrading to 1.0.0 these colors will be inverted.

The easiest fix for this is to replace all occurences of accent_light with accent_light_mode and accent_dark with accent_dark_mode.

accent_light_mode and accent_dark_mode variables are named to reflect the theme (light/dark mode) and work the same way like accent_light and accent_dark variables from previous versions.

What's new

  • Added accent color shades.
  • When running python -m winaccent in terminal a window with the current accent palette will be shown

Version 0.3.0 (August 19, 2024)

What's new

  • Added accent color change listener

Version 0.2.0 (August 18, 2024)

What's new:

  • Removed dependency on darkdetect (this means that accent_auto is now deprecated)
  • Added new function: update_accent_colors()

Version 0.1.0 (August 16, 2024)

The first version ever released.