https://github.com/kiddae/colorer

Because having to change the hex codes manually is annoying.
https://github.com/kiddae/colorer

colorscheme dotfiles dotfiles-manager linux palette python templates unixporn

Last synced: 12 months ago
JSON representation

Because having to change the hex codes manually is annoying.

• Host: GitHub
• URL: https://github.com/kiddae/colorer
• Owner: kiddae
• License: mit
• Created: 2021-01-07T15:06:35.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2023-01-01T18:24:44.000Z (over 3 years ago)
• Last Synced: 2025-04-12T02:05:30.482Z (12 months ago)
• Topics: colorscheme, dotfiles, dotfiles-manager, linux, palette, python, templates, unixporn
• Language: Python
• Homepage:
• Size: 96.2 MB
• Stars: 42
• Watchers: 1
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![banner](demo/banner.png)

![demo](demo/demo.gif)

---

**Because having to change the hex codes manually is annoying,**

`colorer` uses colorscheme files and template configuration files to manage colorschemes and switch between them easily.

## Usage

The colorscheme files are simple text files taking keywords in this format: `key: value`.

In `~∕.config/colorer/templates/`, put the template configuration files. Where you want to use a color from the colorscheme (or any other keyword), put the keyword name in brackets: `{color1}`

You can run `colorer ` to set the colorscheme. Your generated configuration files will be in `~/.config/colorer/out/`. You can now `ln` them or include them into your configs!

Commands to be run after can be added to `~/.config/colorer/commands`; you can also use the same keywords in there.

```

usage: colorer [-h] [-g GET] [-v]

               [colorscheme] [output_dir] [templates_dir] [commands_path]

positional arguments:

  colorscheme        Path to the colorscheme file.

  output_dir         Where to put the generated config files.

  templates_dir      Where the templates are

  commands_path      File containing commands to run at the end.

options:

  -h, --help         show this help message and exit

  -g GET, --get GET  Get a value, don't set a colorscheme.

  -v, --verbose      Print info

```

## Example configuration files

You can find colorschemes in the [dedicated repository](https://github.com/kiddae/colorer-colorschemes); templates for configuration files and commands in my [dotfiles](https://github.com/kiddae/dotfiles)

## Installation

Clone the repo and run `python -m pip install .`

## Troubleshoot

Any fixes to common errors will be added here.