by tlatsas

tlatsas /xcolors

Color themes for Xresources aware terminals.

128 Stars 32 Forks Last release: Not found GNU General Public License v3.0 165 Commits 22 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Build Status


This is the source code that powers xcolors.net. Xcolors.net is a color theme directory for terminals that support color configuration through X resources. It provides a visual presentation of the themes and will hopefully grow over time with help from the community :).

How to use these themes

Download and use the

directive in your
files. Then load/reload using the
utility. For more information see here.


#include "/rezza"


  1. Fork the xcolors repository.

  2. Add your theme file(s) in the

    folder found in the project's root directory.
  3. Commit your changes.

  4. If you make changes to the source code make sure the tests are green.

  5. Make a pull request (make sure you are not on Master branch)

  6. Changes will show at the xcolors site as soon as the PR is merged to the master branch.

  7. You make it to the hall of fame.

Supported formats

Both files using rgb

*color0: rgb:19/19/19
and hash
*color0: #2e3436
notation are supported. Lines starting with
are also supported.

Supported keywords


(from 0 to 15),
, and
are supported. Everything else is ignored.

How this works

Xcolors.net is powered by Flask, the Python micro-framework and is hosted at Heroku. Only the master branch of this repository is deployed at heroku, so this branch should reflect the website contents/state.

With each push to heroku and before the Flask framework fires-up, a bit of python magic happens. The files (themes) that reside in the

folder of the root directory are parsed. Then, for each theme file, a corresponding html file is generated using the Jinja2 engine in the
folder. These files are imported later by the
template, when the main page is requested.

Local install

Navigate in the project's root directory and create the python virtual environment using

$ mkvirtualenv -p /path/to/pyhon2 xcolors

Then activate it:

$ workon xcolors

Intall dependencies using pip:

$ pip install -r requirements.txt

Run using

python xcolors.py
or better use heroku's
which will honor the Procfile contents.
$ foreman start

Run the tests with:

$ python -m unittest discover


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation version 3 of the License.

A copy of theGNU General Public License can be found in GNU Licence Page

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.