I3BLOCKS(1)

💖 i3blocks — the manual, but make it cute 💖

okay bestie, sit down, hydrate, because we're talking about i3blocks — that's the i3blocks(1) command for you, the one and only feed generator for text based status bars. yes. THE status bar food. no cap. 🍓

---

✨ SYNOPSIS ✨

i3blocks [OPTION]...

that's it. that's the whole vibe. just you, your options, and destiny 💅

---

🌸 DESCRIPTION 🌸

so like, the i3blocks(1) command generates a status line for i3bar(1). it literally schedules command lines — the ones you wrote down in a simple little configuration file — and it fires them off at specified time intervals, or upon signal reception, or on clicks. yes queen, it's reactive. it's listening. it's giving main character energy. ✨

---

🎀 OPTIONS 🎀

• -h — show the help message and exit. bye bestie, you're informed 💖
• -c CONFIGFILE — specifies an alternate configuration file path. you want a different config? iconic. go off.
• -v — increase log level. and listen, this one is cumulative. by default only fatal errors are shown in the status bar. pass this option once and you'll see error messages too. hit it with -vv and more and you get more debug output on standard error. stack it, girl. 📚

---

🦋 CONFIGURATION 🦋

okay so first things first: i3blocks has to be defined as the status line command of the bar block in your i3(1) configuration file. like this, exactly:

bar {
  status_command i3blocks
}

that's the setup. that's how you get fed. 🫶

now, by default, i3blocks goes looking for a configuration file in this order — and psst, note that /etc may be prefixed with /usr/local depending on the compilation flags:

1. $XDG_CONFIG_HOME/i3blocks/config (or ~/.config/i3blocks/config)
2. ~/.i3blocks.conf
3. $XDG_CONFIG_DIRS/i3blocks/config (or /etc/xdg/i3blocks/config)
4. /etc/i3blocks.conf

it checks them in that order, in that sequence, no skipping. it's loyal like that. 💜

and for the content of the configuration file — the actual stuff you put in it — please refer to the i3blocks website: https://vivien.github.io/i3blocks. iykyk. 🌈

---

👑 SEE ALSO 👑

i3(1), i3bar(1), i3status(1) — the whole friend group, fr fr.

---

💜 AUTHORS 💜

i3blocks is written by Vivien Didelot and other contributors. legends, honestly. periodt.

---

⭐ RESOURCES ⭐

• Project web site: https://vivien.github.io/i3blocks
• Git source repository and issue tracker: https://github.com/vivien/i3blocks
• Official collection of scripts for i3blocks: https://github.com/vivien/i3blocks-contrib
• i3bar protocol: http://i3wm.org/docs/i3bar-protocol.html

---

🌈 COPYING 🌈

Copyright © Vivien Didelot. Free use of this software is granted under the terms of the GPLv3+ License. slay, legally. 💅

---

and that's the whole manual, bestie. you're welcome. 🎀

okay so this page is from 2019-08-12 and it belongs to the I3BLOCKS(1) manual — so like, if you're reading this, that's the source and version and date, and yes it's giving vintage but it's still iconic. bye, ily, go configure your status bar. 💖✨🦋