🎨 A universal way to change color schemes.
Switch branches/tags
Nothing to show
Clone or download

README.md

Mica

Build Status Mica Documentation Mica Specification

Mica is a universal way to change color schemes. It is written in the Crystal programming language and strives to do one thing and do it well: change color schemes.

Because Mica does one thing and does it well, it can easily be used with tools like pywal and specifications like Base16. Mica is not in charge of making the actual color schemes. It simply applies the color schemes you give it to all the programs you specify.

With Mica, you only need one configuration file to easily change color schemes in all your favorite software. Mica makes it easy to style your browser, start page, and much more!

Installation

You can install Mica from the Arch User Repository using an AUR helper like yay.

yay -S mica

You can install Mica manually by cloning this repository and using make install. Make sure that you have the Crystal programming language installed so you can build Mica!

Usage

The first thing you want to do is download some color schemes to use with Mica. A good place to start is the Base16 Materia color scheme. Once you have downloaded the color scheme, you can apply it easily like so:

mica materia.yaml

That's it! Mica handles the rest. Mica determines that you gave it a Base16 color scheme and applies it to all the programs you specified in your config file.

You can put color schemes in the ~/.config/mica/ directory. This lets you reference color schemes directly, like so:

mica materia

If you want more Base16 color schemes, check out its repository.

Examples & Inspiration

Mica does one thing and does it well: change color schemes. This lets you do some pretty cool stuff with it. Simply put, if it involves changing color schemes, then you can do it!

Some of the things that you can do with Mica include:

  • Changing your color scheme based on the time of day (day vs night, etc.).
  • Changing your color scheme based on what day it is (weekends, holidays, etc.).
  • Changing your color scheme based on your desktop background.
  • Changing your color scheme based on images you open, videos you watch, and anything else you can think of!

If you have a particularly interesting way of using Mica, please consider adding it here!

Contributing

Do you want to contribute to Mica? Great! Mica is designed from the ground up to be easily extensible. Mica is written in the Crystal programming language, a fun and straight-forward compiled programming language that has speeds comparable to C. Mica makes it easy to add support for your favorite software.

To get started, read the contributing guidelines.

License

Mica is free software. Except where otherwise noted, Mica is licensed under the terms of the GNU General Public License, either version 3, or at your option, any later version.