# vivien/i3blocks

The hacker-friendly status_command for Sway and i3

Repository: https://github.com/vivien/i3blocks
Canonical: https://ross.abutalabs.com/products/i3blocks
Homepage: https://vivien.github.io/i3blocks/
Language: C
License: GPL-3.0
License Family: copyleft
Topics: sway, i3, i3bar, i3wm, swaybar, swaywm
Last push: 2023-11-22T16:43:39+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4590, "days_push": 1015, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_readme
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2472, forks 184 (observed 2026-08-28T04:06:54.791912+00:00)

## What it is
i3blocks is a hacker-friendly status line generator for the i3 and Sway window managers, executing user-defined commands on intervals, signals, or clicks. It serves as a flexible drop-in replacement for i3status, outputting text for i3bar/swaybar.

## Use cases
- show a custom clock, weather, or IP address in my i3 status bar
- replace i3status with a more flexible status command
- run shell scripts periodically and display their output in swaybar
- make status bar blocks clickable and reactive to signals
- generate status line output from any programming language

## When to choose
- you use i3 or Sway and want full control over your status bar content
- you prefer writing simple shell commands or scripts instead of configuring a monolithic status program
- you need per-block intervals, click handling, or signal-driven updates

## When to avoid
- you use a desktop environment with its own panel
- you want a batteries-included status bar with built-in modules and no scripting
- you are not using i3bar or swaybar as your status bar renderer

## Facets
- artifact type: cli-tool
- maturity: stable
- function: cli, developer-tools
- domain: desktop-applications, developer-tools
- platform: cli
- tags: i3, sway, status-bar, i3bar, swaybar, window-manager, c, command-line, linux

## Member repositories
- vivien/i3blocks (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:54.791912+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:28:33.479172+00:00, confidence not recorded.
  - homepage: https://vivien.github.io/i3blocks/ (fetched 2026-08-29T10:10:31.260398+00:00, sha e47a0a681652)
- Data as of 2026-08-30T08:39:29.467469+00:00.