Scroll to navigation

yambar-modules-i3(5) File Formats Manual yambar-modules-i3(5)


i3 - This module monitors i3 and sway workspaces


Unlike other modules where the content attribute is just a single particle, the i3 module's content is an associative array mapping i3/sway workspace names to a particle.

You can add an empty workspace name, "", as a catch-all workspace particle. The i3 module will fallback to this entry if it cannot find the workspace name in the content map.

It also recognizes the special name current, which always represents the currently focused workspace. On Sway, this can be used together with the application and title tags to replace the X11-only xwindow module.


Name Type Description
name string The workspace name
visible bool True if the workspace is currently visible (on any output)
focused bool True if the workspace is currently focused
urgent bool True if the workspace has the urgent flag set
empty bool True if the workspace is empty (Sway only)
state string One of urgent, focused, unfocused or invisible (note: unfocused is when it is visible, but neither focused nor urgent).
application string Name of application currently focused on this workspace (Sway only - use the xwindow module in i3)
title string This workspace's focused window's title
mode string The name of the current mode


Name Type Req Description
content associative array yes Unlike other modules, content is an associative array mapping workspace names to particles. Use "" to specify a default fallback particle, or current for the currently active workspace.
sort enum no How to sort the list of workspaces; one of none, native, ascending or descending, defaults to none. Use native to sort numbered workspaces only.
strip-workspace-numbers bool no If true, N: prefixes will be stripped from workspace names. Useful together with sort, to have the workspace order fixed.
persistent list of strings no Persistent workspaces. I.e. workspaces that are never removed, even if empty.
left-spacing int no Space, in pixels, on the left-side of each rendered workspace particle
right-spacing int no Space, in pixels, on the right-side of each rendered workspace particle
spacing int no Short-hand for setting both left-spacing and right-spacing


This renders all workspace names, with an * indicating the currently focused one. It also renders the currently focused application name and window title.


- i3:
default: {string: {text: "{name}"}}
state == focused: {string: {text: "{name}*"}}
current: { string: {text: "{application}: {title}"}}


yambar-modules(5), yambar-particles(5), yambar-tags(5), yambar-decorations(5)