Skip to main content

Material You color generation algorithms in pure python!

Project description

materialyoucolor-pyhton

Material You color algorithms for python (crossplatform)!

SEE : https://m3.material.io/styles/color/dynamic-color/overview

How does it works?

Android performs the following steps to generate color schemes from a user's wallpaper.

  1. The system detects the main colors in the selected wallpaper image and extracts a source color.

  2. The system uses that source color to further extrapolate five key colors known as Primary, Secondary, Tertiary, Neutral, and Neutral variant.

img Figure 1. Example of source color extraction from wallpaper image and extraction to five key colors

  1. The system interprets each key color into a tonal palette of 13 tones.

img2 Figure 2. Example of generating a given tonal palettes

  1. The system uses this single wallpaper to derive five different color schemes, which provides the basis for any light and dark themes.

SEE MORE: https://developer.android.com/develop/ui/views/theming/dynamic-colors

Where to use this colors?

SEE : https://m3.material.io/styles/color/the-color-system/color-roles

Install

Always prefer master branch

pip3 install https://github.com/T-Dynamos/materialyoucolor-pyhton/archive/main.zip

or

pip3 install materialyoucolor

Documentation

Please see example.py, its well documented by AI.

Example

Install kivy,pillow, kivymd and then run example.py file.

Make sure to edit variables in example.py file, like

IMAGE_FILE = "/home/tdynamos/Downloads/test.png"  # file
Input Output
Image 1 Image 2

See all tokens : https://m3.material.io/styles/color/the-color-system/tokens

Credits

https://github.com/fengsp/color-thief-py/blob/master/colorthief.py

https://github.com/avanisubbiah/material-color-utilities

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

materialyoucolor-1.1.tar.gz (16.9 kB view hashes)

Uploaded Source

Built Distribution

materialyoucolor-1.1-py3-none-any.whl (19.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page