Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time



This software is intended for use by painters who wish to experiment
with mixing paint (virtually) and to plan palettes.  See section USAGE
below for more details.


This software is still under development and is only Beta standard at
this time.


There are two versions of this software: a Python3 script and a Rust
compilable program.

The Python3 version of the software requires:
 - Python 3.4.3 or later
 - PyGObject 3.22 or later

The Rust version requires rustc 1.26.2 or later.


It is NOT necessary to install this software in order to use it.  All
that is necessary for the Python3 version to be usable is for the base
directory to be in the user's PATH environment variable.  For the Rust
version all that is required is for the .target/release and/or
.target/debug (as appropriate) to be in the user's PATH environment


The software's GUI ( or pcatk_rs) has 2 selectable components:

1. The Palette Planner is a GUI the component that (once the user
has slected some paint colours for use) enables the painter to mix new
colours by specifying the number of "parts" of paint (or earlier mixed)
colours to be used in a mixed colour.  This mixed colour can then be
saved to a list of mixed colours (along with notes about its intended
use) and used in the mixing of further colours.  When the painter has
finished planning their palette they may print out a report to be used
as a reference while completing the painting for which the palette was
planned. An analysed image viewer is included as part of the palette
planner and displays a number of transformations of a (user selected)
digital image from which the user can copy samples for pasting into
the mixed colour area for matching.

2. The Paint Series Editor is the component that enables the
painter create sets of paint colours for use in the palette planner.
The recommended method is to produce a "sampler" of the actual paints
to be used on a suitable medium, take a digital photograph and then
cut and paste from that photograph into the paint series editor where
its buttons can be used to match the colour.  A Colour Sample Viewer
is included as part of the editor. An example colour sampler
file has been added and should be loaded by the viewer the first time
it is launched (and after that it should remember the last file used).


At this time, the only paint series data included in the distribution is for an
imaginary set of paints known as the "Ideal Paint Colours Series" which
features six colours equally spaced around the colour circle (at maximim chroma)
together with black and white. This series can be found in the file "ideal.tsd"
in the "data" subdirectory of the source distribution and in the directory
"$ROOT/share/PaintersColourAssistant/data" in installed distributions. On Linux
$ROOT should be "/usr" and to facilitate finding the file on Windows the file
selector should open in that directory when the "Paint Colour Series/Open" menu
option in the Palette Planner is invoked.


The Python3 code is extensively hooked for i18n but (at the moment)
there is no localization available for languages other than English.


It would be greatly appreciated if any bugs encountered by users are
reported by creating an issue at:



Feature requests can be made by creating an issue at:



No description, website, or topics provided.




No packages published
You can’t perform that action at this time.