Skip to content

Arrange your panels ​

The bar is one or more [[panels]] tables in ~/.config/glimpse/panel.toml. Save the file and the change applies. The full setting list is in the panels reference.

TIP

The moment you write your first [[panels]] table, the default panel is gone and glimpse shows only the panels you wrote.

Reorder applets ​

Each panel has three zones, left, center and right, and each lists applet names in the order they appear on screen. To move an applet, move its name. A zone you write replaces the whole default list, so a name you leave out disappears from the bar. This example keeps every default applet and moves the clock to the end of the center zone:

toml
[[panels]]
left = ["workspace-name", "pager", "places", "mpris"]
center = ["weather", "notifications", "privacy", "clock"]
right = [
    "next-event", "tray", "removable", "clipboard", "printing", "bluetooth",
    "network", "display", "audio", "idle", "power", "keyboard", "session",
]

Move the bar to another edge ​

position takes top (the default), bottom, left or right:

toml
[[panels]]
position = "bottom"

Change the bar's size ​

size is the least thickness in pixels: the height of a top or bottom bar, the width of a side bar. The default is 36. A bar is never thinner than its tallest applet, about 30 pixels, and a side bar is as wide as its widest applet, so a clock label makes it about 120 pixels wide.

toml
[[panels]]
size = 42

A larger size applies when you save. A smaller one takes effect the next time the panel starts.

Float the bar ​

A [panels.margin] table pulls the bar away from the screen edges, in pixels. It belongs to the [[panels]] table above it, and windows keep clear of the bar and its margin:

toml
[[panels]]
position = "top"

[panels.margin]
top = 8
left = 12
right = 12

Put a second bar on another monitor ​

Add one [[panels]] table per bar and name the monitor by its connector. This keeps the full bar on the laptop screen and adds a smaller one on an external monitor:

toml
[[panels]]
monitor = "eDP-1"

[[panels]]
monitor = "DP-1"
size = 30
left = ["pager"]
center = ["clock"]
right = ["notifications"]

A panel without monitor appears on every monitor, and a zone you leave out keeps its default applets. A panel whose monitor matches no connected monitor does not appear, and glimpse does not warn you, so check the spelling. glimpsectl applet list lists every applet with the connector its panel is on.

Remove an applet ​

Delete its name from the zone list. To empty a zone completely, set it to []:

toml
[[panels]]
center = []
right = ["tray", "network", "audio"]

A name glimpse cannot resolve (a typo, an applet that is not installed) is left out, and the panel posts a notification telling you which one.

Released under the BSD 3-Clause license.