README.md

farben

This library provides an easy way to generate color palettes:

In computer graphics, a palette is a finite set of colors. — Wikipedia article 'Palette (Computing)'

.. often referred to as Swatches (as branded by Adobe Inc.):

Swatches are named colors, tints, gradients, and patterns. — Adobe Illustrator

.. featuring the following (proprietary) color spaces:

• PANTONE®
• RAL®
• Dulux®
• Copic®
• NCS®
• HKS®
• Prismacolor®

For now, farben creates master palettes for use in

• Scribus (XML)
• GIMP (GPL)
• AutoCAD (ACB)
• Inkscape (GPL)
• Krita (GPL)
• LibreOffice (SOC)

Installation

It's available from PyPi:

# Using 'pip'
pip install farben

# Using 'poetry'
poetry add farben

Getting started

Using this library is straightforward - otherwise, --help is your friend:

$ farben fetch --help
Usage: farben [OPTIONS] COMMAND [ARGS]...

  PANTONE®, RAL®, Dulux®, Copic®, NCS®, HKS® and Prismacolor® color palettes
  for Scribus, GIMP, AutoCAD, Inkscape, Krita & LibreOffice.

Options:
  -v, --version  Show the version and exit.
  -h, --help     Show this message and exit.

Commands:
  fetch  BRANDS: pantone | ral | dulux | copic | ncs | hks | prismacolor

Using its fetch command is fairly easy, like that:

# Example 1
# - all brands
# - all palettes
$ farben fetch

# Example 2
# - all brands
# - only specific palette(s)
$ farben fetch -p gpl
$ farben fetch -p gpl -p acb

# Example 3
# - only specific brand(s)
$ farben fetch copic
$ farben fetch copic dulux

.. you get the idea!

FAQ

Q: But where do all those files go? A: That depends, ..

• .. .xml files may be loaded individually with Edit - Colours & Fills - Solid Colours - Import (Scribus)
• .. .soc files belong here:
  • ~\AppData\Roaming\libreoffice\3\user (Windows + PowerShell, otherwise %userprofile%)
  • ~/Library/Application Support/libreoffice/4/user/config (Mac)
  • ~/.config/libreoffice/4/user/config (Linux)
• .. installing .gpl files boils down to:
  • moving them to any path specified in Edit - Preferences - Folders - Palettes (GIMP)
  • moving them to palettes under directory specified in Edit - Preferences - System - User Config (Inkscape)
  • importing them using the palette docker (Krita)
• .. installing .acb files is pretty straightforward

Color samples

If you are looking for a quick way to browse PANTONE® colors, check out the Pantone Finder package or visit their website to get started.

Once you retrieved color palettes, you can

• view them using PHP like this: cd examples/{brand} && php -S localhost:8000
• view static HTML page like this: cd examples && python build.py

When clicking on a color tile, its hex value is copied to your clipboard (powered by clipboard.js).

Copyright

Whenever mentioned throughout this project, PANTONE® and related trademarks are the property of Pantone LLC, a division of X-Rite, a Danaher company.

The same applies to ..

• RAL® and related trademarks of RAL gGmbH (non-profit LLC) and RAL Deutsches Institut für Gütesicherung und Kennzeichnung e. V.
• Dulux® and related trademarks of AkzoNobel N.V. (worldwide) and DuluxGroup (Australia & New Zealand)
• Copic® and related trademarks of Too Marker Corporation
• Natural Colour System® and related trademarks of NCS Colour AB
• HKS® and related trademarks of HKS Warenzeichenverband e.V
• Prismacolor® and related trademarks of Berol Corporation, owned by Sanford L.P., a Newell Brands company.

We assume neither ownership nor intellectual property of any kind - color codes (and names), sRGB and/or hexadecimal values are publically available on the internet.

Similar projects

• For Scribus, there's also the (currently unmaintained) package SwatchBooker

Happy coding!

©️ Fundevogel Kinder- und Jugendbuchhandlung