bumblebee-status is a modular, theme-able status line generator for the i3 window manager.
Find a file
2020-04-13 13:06:50 +02:00
.github Update issue templates 2019-10-12 15:11:45 +02:00
core [core/module] For errors, always set update interval to 1 2020-04-13 09:43:45 +02:00
doc [doc] Updates and restructuring 2020-04-13 09:11:19 +02:00
modules [modules/yubikey] Update less frequently 2020-04-13 09:44:06 +02:00
tests [core] Rename events for more clarity 2020-04-12 20:11:02 +02:00
themes [core/output] Add generic pango support 2020-04-04 14:38:37 +02:00
util [modules/vault] Update to new API 2020-04-11 13:35:12 +02:00
.codeclimate.yml [codeclimate] Ignore thirdparty modules 2017-09-30 11:57:04 +02:00
.coveragerc [coveragerc] excludelines somehow broke the build for Python 2.7 2017-03-04 18:54:42 +01:00
.gitignore [build] Add preliminary debian package build 2019-01-02 14:40:23 +01:00
.travis.yml [travis] Exclude codeclimate 2020-02-02 14:42:32 +01:00
__init__.py [tests] Move from nosetests to unittest 2020-02-02 13:27:03 +01:00
bumblebee-status [modules/yubikey] Update to new API 2020-04-13 09:40:24 +02:00
CODE_OF_CONDUCT.md Create CODE_OF_CODUCT.md 2017-06-15 12:58:13 +02:00
CONTRIBUTING.md [doc] Update contributing 2020-04-13 13:06:50 +02:00
coverage.sh [tests] Do not show stdout/stderr by default 2020-02-02 14:41:45 +01:00
LICENSE Initial commit 2016-10-30 15:07:21 +01:00
README.md [doc] Updates and restructuring 2020-04-13 09:11:19 +02:00

bumblebee-status

Build Status Code Climate Test Coverage Issue Count

Many, many thanks to all contributors! All of the really cool modules have been contributed by somebody else :)

List of modules

Solarized Powerline

bumblebee-status is a modular, theme-able status line generator for the i3 window manager.

Focus is on:

I hope you like it and I appreciate any kind of feedback: Bug reports, feature requests, etc. :)

Thanks a lot!

Required i3wm version: 4.12+ (in earlier versions, blocks won't have background colors)

Supported Python versions: 3.4, 3.5, 3.6, 3.7, 3.8

Supported FontAwesome version: 4 (free version of 5 doesn't include some of the icons)

Example usage:

bar {
	status_command <path>/bumblebee-status -m cpu memory battery time pasink pasource -p time.format="%H:%M" -t solarized
}

Documentation

See the docs for documentation.

See FAQ for FAQs.

Other resources:

Installation

$ git clone git://github.com/tobi-wan-kenobi/bumblebee-status

Dependencies

Available modules lists the dependencies (Python modules and external executables) for each module. If you are not using a module, you don't need the dependencies.

Usage

Normal usage

In your i3wm configuration, modify the status_command for your i3bar like this:

bar {
	status_command <path to bumblebee-status/bumblebee-status> \
		-m <list of modules> \
		-p <list of module parameters> \
		-t <theme>
}

You can retrieve a list of modules (and their parameters) and themes by entering:

$ cd bumblebee-status
$ ./bumblebee-status -l themes
$ ./bumblebee-status -l modules

Any parameter you can specify with -p <name>=<value>, you can alternatively specify in ~/.bumblebee-status.conf or ~/.config/bumblebee-status.conf. This parameters act as a fallback, so values specified with -p have priority.

Parameters can also be used to override theme settings, such as:

$ ./bumblebee-status -p <module>.theme.<theme field>=<value>
# for example, to get a spacer with a red background:
$ ./bumblebee-status -m spacer -p spacer.theme.bg=#ff0000

Configuration files have a format like this:

$ cat ~/.bumblebee-status.conf
[module-parameters]
<key> = <value>

For example:

$ cat ~/.bumblebee-status.conf
[module-parameters]
github.token=abcdefabcdef12345

To change the update interval, use:

$ ./bumblebee-status -m <list of modules> -p interval=<interval in seconds>

As a simple example, this is what my i3 configuration looks like:

bar {
	font pango:Inconsolata 10
	position top
	tray_output none
	status_command ~/.i3/bumblebee-status/bumblebee-status -m nic disk:root cpu memory battery date time pasink pasource dnf -p root.path=/ time.format="%H:%M CW %V" date.format="%a, %b %d %Y" -t solarized-powerline
}

Restart i3wm and - that's it!

Examples

List of themes