https://github.com/facelessuser/coloraide

A library to aid in using colors
https://github.com/facelessuser/coloraide

color-contrast color-conversion color-difference color-filters color-harmonies color-interpolation color-manipulation color-spaces color-temperature color-vision-deficiency colors colour css python

Last synced: 30 days ago
JSON representation

A library to aid in using colors

• Host: GitHub
• URL: https://github.com/facelessuser/coloraide
• Owner: facelessuser
• License: mit
• Created: 2020-08-30T18:09:56.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2024-09-30T16:59:53.000Z (about 1 month ago)
• Last Synced: 2024-10-04T13:40:52.145Z (about 1 month ago)
• Topics: color-contrast, color-conversion, color-difference, color-filters, color-harmonies, color-interpolation, color-manipulation, color-spaces, color-temperature, color-vision-deficiency, colors, colour, css, python
• Language: Python
• Homepage: https://facelessuser.github.io/coloraide
• Size: 123 MB
• Stars: 191
• Watchers: 4
• Forks: 11
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

README

        
[![Donate via PayPal][donate-image]][donate-link]

[![Build][github-ci-image]][github-ci-link]

[![Coverage Status][codecov-image]][codecov-link]

[![PyPI Version][pypi-image]][pypi-link]

[![PyPI Downloads][pypi-down]][pypi-link]

[![PyPI - Python Version][python-image]][pypi-link]

![License][license-image-mit]

# ColorAide

## Overview

ColorAide is a pure Python, object oriented approach to colors.

```python

>>> from coloraide import Color

>>> c = Color("red")

>>> c.to_string()

'rgb(255 0 0)'

>>> c.convert('hsl').to_string()

'hsl(0 100% 50%)'

>>> c.set("lch.chroma", 30).to_string()

'rgb(173.81 114.29 97.218)'

>>> Color("blue").mix("yellow", space="lch").to_string()

'rgb(255 65.751 107.47)'

```

ColorAide particularly has a focus on the following:

- Accurate colors.

- Proper round tripping (where reasonable).

- Be generally easy to pick up for the average user.

- Support modern CSS color spaces and syntax.

- Make accessible many new and old non-CSS color spaces.

- Provide a number of useful utilities such as interpolation, color distancing, blending, gamut mapping, filters,

  correlated color temperature, color vision deficiency simulation, etc.

- Provide a plugin API to extend supported color spaces and approaches to various utilities.

- Allow users to configure defaults to their liking.

With ColorAide, you can specify a color, convert it to other color spaces, mix it with other colors, output it in

different CSS formats, and much more!

# Documentation

https://facelessuser.github.io/coloraide

## License

MIT

[github-ci-image]: https://github.com/facelessuser/coloraide/workflows/build/badge.svg?branch=main&event=push

[github-ci-link]: https://github.com/facelessuser/coloraide/actions?query=workflow%3Abuild+branch%3Amain

[codecov-image]: https://img.shields.io/codecov/c/github/facelessuser/coloraide/main.svg?logo=codecov&logoColor=aaaaaa&labelColor=333333

[codecov-link]: https://codecov.io/github/facelessuser/coloraide

[pypi-image]: https://img.shields.io/pypi/v/coloraide.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333

[pypi-down]: https://img.shields.io/pypi/dm/coloraide.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333

[pypi-link]: https://pypi.python.org/pypi/coloraide

[python-image]: https://img.shields.io/pypi/pyversions/coloraide?logo=python&logoColor=aaaaaa&labelColor=333333

[license-image-mit]: https://img.shields.io/badge/license-MIT-blue.svg?labelColor=333333

[donate-image]: https://img.shields.io/badge/Donate-PayPal-3fabd1?logo=paypal

[donate-link]: https://www.paypal.me/facelessuser