Skip to main content

i3 config generation tool

Project description

Project Status: Active – The project has reached a stable, usable state and is being actively developed.

Generate i3 config files from a set of partials in a config folder. Do some nifty conditional integration and variable resolution (also for i3status configs). This makes switching of themes (optical or via key binding or whatever) possible.

Why?

  • To be able to switch parts of the config dynamically depending on selectors

  • To be able to assign variables to variables and use variables in the status bar configurations

  • To be able to split my long and messy config file in many short, aptly named, messy config partials

How?

This can best be understood by how I use this to generate my own i3 config - here are the config partials: .i3/config.d

The call

$ i3configger --select-host=$(hostname) --select-theme=solarized-dark

creates config and i3status.main.conf from the sources.

The idea is simple:

Config partials that follow the naming scheme <selector>.<name>.conf are only rendered into the config if explicitly requested.

  • The partial host.ob1.conf will be rendered if the option --select-host=ob1 is passed to i3configger.

  • The partial theme.solaris-dark.conf will only be rendered if --select-theme=solaris-dark is passed.

host and theme are selector names I chose for my use case, but they can be freely chosen as long as the naming scheme is adhered to.

Features

  • build main config and one or several i3status configs from the same sources

  • render variables slightly more intelligently than i3 does it

  • also render variables in i3status configs (set anywhere in the sources)

  • reload or restart i3 when a change has been done (using i3-msg)

  • notify when new config has been created and activated (using notify-send)

  • simple way to render partials based on selectors (see example above)

  • simple way to communicate settings to renderer ($i3configger_key value)

  • build config as one shot script or watch for changes (foreground and daemon)

Some things are still in the air - see notes.

Installation

You should install this into a Python 3.6 interpreter.

i3configger is released on the Python Package Index. The standard installation method is:

$ pip install i3configger

Usage

Default uses ``.i3config`` files in ``~/.i3/config.d`` and writes to ``~/.i3/config``.

one shot:

$ i3configger

as daemon:

$ i3configger --daemon

more info:

$ i3configger --help

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

i3configger-0.2.1.tar.gz (12.3 kB view details)

Uploaded Source

File details

Details for the file i3configger-0.2.1.tar.gz.

File metadata

  • Download URL: i3configger-0.2.1.tar.gz
  • Upload date:
  • Size: 12.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for i3configger-0.2.1.tar.gz
Algorithm Hash digest
SHA256 3405d1324d02659fa444002a6aa29f47e57cc3e928cbf861f5c1e9eea52c45a7
MD5 6b4e672e716258a002a11b1298be13b6
BLAKE2b-256 17e1a8babdfd9819c8ab9df2c02e0f322265ca0ed441d902cdd33377a6a19a5f

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page