i3-style

    0.10.0 • Public • Published

    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.

    Install

    npm i i3-style

    DownloadsWeekly Downloads

    33

    Version

    0.10.0

    License

    BSD-2-Clause

    Last publish

    Collaborators

    • tonyctl