Winaccent

<div id="toc"> <ul style="list-style: none; padding: 0px;"> <h1> <summary> <h><img src="https://raw.githubusercontent.com/Valer100/winaccent/refs/heads/main/assets/logo/logo_fluent.svg" height=100 alt="winaccent logo" align="left"/><h3>winaccent</h3></h> </summary> <p></p> </h1> </ul> </div> <br>

A simple and lightweight Python module for easily retrieving Windows' accent color, including shades, specific window chrome colors such as active/inactive titlebar and window borders and theme. Supports Windows 8.x, 10 and 11 and doesn't require additional dependencies.

📦 Installation

Run this command in your terminal:

pip install winaccent

To update the module, run this command:

pip install --upgrade winaccent

📝 Requirements

• Windows 8.0 or newer
• Python 3.6 or newer

📜 Documentation

The documentation is available here.

💻 Demo

To see a demo, run the following command in your terminal (winaccent must be installed):

python -m winaccent

This command has an optional --mode argument. It can take the following values:

| Value | Info | |:------|:-----| | gui | Shows a GUI demo. The GUI demo responds to accent color changes. | | console | Shows a console demo. The console demo does not respond to accent color changes. | | auto | If tkinter is installed and works correctly, a GUI demo will be shown. If that's not the case, a console demo will be shown. |

Example usage:

python -m winaccent --mode gui

The command will run with --mode set to auto by default.

<details> <summary>Show GUI demo screenshots</summary> <br>

| Windows 11 | Windows 10 | Windows 8.x | |:--------------:|:--------------:|:---------------:| | | | |

</details> <details> <summary>Show console demo output</summary> <br>

Accent palette
==============

accent_light_3:                 #99EBFF
accent_light_2:                 #4CC2FF
accent_light_1:                 #0091F8
accent_normal:                  #0078D4
accent_dark_1:                  #0067C0
accent_dark_2:                  #003E92
accent_dark_3:                  #001A68


Window chrome
=============

is_titlebar_colored:            False
titlebar_active:                #F3F3F3
titlebar_active_text:           #000000
titlebar_inactive:              #F3F3F3
titlebar_inactive_text:         #929292
window_border_active:           #757575
window_border_inactive:         #757575


Start Menu
==========

is_start_menu_colored:          False
start_menu:                     #242424


Taskbar
=======

is_taskbar_colored:             False
taskbar:                        #1C1C1C


UI Appearance
=============

transparency_effects_enabled:   True
apps_use_light_theme:           False
system_uses_light_theme:        False


Other colors
============

accent_menu:                    #0078D4

</details>

🤩 Feedback

If you found a bug or want to make a suggestion, open a new issue. If you're ready to add a new feature or fix a bug, pull requests are welcome.

If you found this module useful, please consider starring this repository.