https://github.com/valer100/winaccent

A simple and lightweight Python module for easily retrieving Windows' accent color, including shades, specific window chrome colors and theme. Supports Windows 8.x, 10 and 11 and doesn't require additional dependencies.
https://github.com/valer100/winaccent

accent accent-color color color-scheme colors dark-mode fluent fluent-design gui python user-interface win32 winaccent windows windows-10 windows-11 windows-8 windows10 windows11 windows8

Last synced: 14 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/valer100/winaccent
• Owner: Valer100
• License: mit
• Created: 2024-08-16T10:50:44.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-06-24T16:53:24.000Z (3 months ago)
• Last Synced: 2025-06-24T17:38:34.901Z (3 months ago)
• Topics: accent, accent-color, color, color-scheme, colors, dark-mode, fluent, fluent-design, gui, python, user-interface, win32, winaccent, windows, windows-10, windows-11, windows-8, windows10, windows11, windows8
• Language: Python
• Homepage: https://pypi.org/project/winaccent/
• Size: 49.8 MB
• Stars: 21
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


    


        


            

                
winaccent

            

            



        

    






[![PyPI](https://img.shields.io/pypi/v/winaccent)](https://pypi.org/project/winaccent/)

[![Python](https://img.shields.io/badge/python-3.6+-blue)]()

[![Windows](https://img.shields.io/badge/windows-8.0+-blue)]()

[![Format](https://img.shields.io/pypi/format/winaccent)](https://pypi.org/project/winaccent/)

[![Downloads](https://img.shields.io/pepy/dt/winaccent)](https://pypi.org/project/winaccent/)

[![Stars](https://img.shields.io/github/stars/Valer100/winaccent?style=flat&color=yellow)](https://github.com/Valer100/winaccent/stargazers)

[![Contributors](https://img.shields.io/github/contributors/Valer100/winaccent)](https://github.com/Valer100/winaccent/graphs/contributors)

[![Last commit](https://img.shields.io/github/last-commit/Valer100/winaccent)](https://github.com/Valer100/winaccent/commits/main)

[![Commits since latest release](https://img.shields.io/github/commits-since/Valer100/winaccent/latest)](https://github.com/Valer100/winaccent/commits/main)

[![License](https://img.shields.io/github/license/Valer100/winaccent)](https://github.com/Valer100/winaccent/blob/main/LICENSE)

[![Documentation](https://img.shields.io/badge/documentation-here-blue)](https://valer100.github.io/winaccent)

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](https://valer100.github.io/winaccent).

## 💻 Demo

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

```python

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.

Show GUI demo screenshots




| **Windows 11** | **Windows 10** | **Windows 8.x** |

|:--------------:|:--------------:|:---------------:|

| ![Windows 11 default](https://github.com/Valer100/winaccent/blob/main/assets/demo4/win11.png?raw=true) | ![Windows 10 default](https://github.com/Valer100/winaccent/blob/main/assets/demo4/win10.png?raw=true) | ![Windows 8 default](https://github.com/Valer100/winaccent/blob/main/assets/demo4/win8.png?raw=true) |

Show console demo output




```

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

```

## 🤩 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.