Skip to content

Latest commit

 

History

History
55 lines (29 loc) · 2.1 KB

README.md

File metadata and controls

55 lines (29 loc) · 2.1 KB

i3-style

Make your i3 config a little more stylish.

NPM

NPM

About

i3-style applies a theme to your i3 config file to change the colorscheme of the window decorations and the different parts of i3bar. It's designed especially for people who make frequent changes to their colorscheme to get things just right.

  • Easy to try out new themes right after you install.
  • Themes are easy to read, modify, and share.
  • Modifies your theme in place - extra template files are not needed.

For an overview of the capabilities of i3-style, see my blog post.

Installing

To install with npm:

npm install -g i3-style

The i3-style executable should now be in your PATH.

Usage

Just call i3-style with the name of the theme you want to try and where you want to write the config file to. i3-style will look for your config in the default place and apply the theme.

i3-style solarized -o ~/.i3/config --reload

Check the themes directory for the list of built-in themes.

If you want to modify a theme, copy it from themes and give it a .yaml extension. The object format is well-documented and includes support for color aliases. Then back up your config and call i3-style.

i3-style ~/.i3/solarized.yaml -o ~/.i3/config

Just keep doing that until you get it perfect (which might be never).

Send us themes!

Do you have a cool colorscheme in your config file that you want to share with other people? i3-style can automatically convert it to a theme file:

i3-style --to-theme ~/.i3/config -o my-theme.yaml

If you have a new theme, or made an improvement to an existing theme, please make a pull request adding your theme to the themes directory!

License

This work is available under a FreeBSD License (see LICENSE).

Copyright © 2013, Tony Crisci

All rights reserved.