simple-i3blocks/README.md

simple-i3blocks

This is a simple collection of i3blocks-modules accompagnied by a config file with the aim to display only important information in favor of not spilling lots of numbers into the status bar.

Usage

• module datetime: A left click will toggle long and short displays. The short version is displayed in the format HH:MM. The long version also shows the day of the week, weeknumber, date and seconds.
• module audio: instance=mic will show the microphone level instead. With a left mouse click the device is muted/unmuted.
• module ram: by default free ram and swap are shown in the format a+b G where a is ram and b is swap. If you want to show ram and swap seperatly, use instance=ram or instance=swap. If you left click on the block, top will be openend.
• cpu: by default total idle cpu time of all cores together is displayed using a vertical block symbol. Use instance=long to show the percentage instead. If you left click on the block, top will be openend.
• module battery: By default the total energy left of all batteries is shown using a vertical block symbol. Use instance=x to show the status of BATx in case you have more than one battery in /sys/class/powersupply. On Left click, the long percentage is shown.
• module backlight: By default the brightness level is shown in the default font color (depending on your i3 config). Use instance=long to show the brightness percentage. Use instance="color" to print the brightness level colored which is nice when using a device in battery mode. On left click the brightness in percent will be shown.

Requirements

Install i3 window manager alongside with i3blocks and git. The following shows the requirements for each module:

module      dependency
--------------------------
audio       amixer
battery     none, searches in /sys/class/power_supply/BAT...
cpu         top, htop for click support
datetime    date
ip          curl
ram         none, searches in /proc/meminfo, htop for click support
storage     df
backlight   none, searches in /sys/class/backlight, intel and ati/amd supported

Install

One-Liner: Open up a terminal and paste: bash <(curl -s https://will.kein.hk/git/koksnuss/simple-i3blocks/raw/master/install.sh)

• Backup: mv ~/.config/i3blocks{,.bak}
• Clone: git clone https://will.kein.hk/git/koksnuss/simple-i3blocks.git ~/.config/i3blocks
• Adjust ~/.config/i3blocks/config to control i3 status bar output (see Usage).
• Make sure you've added bar { status_command i3blocks } in your i3-config file (i.e. ~/config/i3/config).
• Finally reload your i3 window manager. The default shortcut is mod + SHIFT + r, you should see a flickering.

Roadmap

Modules

• datetime
• ram/swap
• cpu
• audio/mic
• storage
• ip
• battery
• backlight
• wifi/ethernet/bluetooth
• external storage
• ethernet bandwith

Click interactions

• datetime: left: show weekday, date, weeknumber and seconds
• audio/mic: left: toggle mute
• ram/cpu: left: open top in a terminal
• external storage: mount it somewhere

Signals

• audio, mic
• backlight

Other

• nice icons as labels