Applets

An applet is one item on a panel. You place applets by name in a panel's left, center and right lists, and change how one behaves in a table named after it. Both live in panel.toml:

[applets.clock]
label-format = "%a %-d %b  %H:%M"
week-numbers = true

An applet you never mention in [applets] runs with its defaults.

Running an applet twice

To show the same applet twice with different settings, give the second copy its own name and say which applet it is with extends. Then place it by that name:

[applets.clock-utc]
extends = "clock"
timezone = "UTC"
label-format = "UTC %H:%M"

[[panels]]
center = ["clock", "clock-utc"]

A table named after a built-in applet, such as [applets.clock], doesn't need extends.

Tooltips

Every applet takes tooltip-format, which sets what its tooltip on the bar says. Most applets replace tokens in braces with live values. Each applet's section below lists its tokens and the format it uses when you set none, which is a good starting point to copy:

[applets.network]
tooltip-format = "{connection}\n{metered}"

System

audioSpeaker and application volume.bluetoothBluetooth and paired devices.networkYour network connections.displayDisplays, brightness and night light.powerBattery, power mode, keep awake and peripheral batteries in its popover.keyboardThe active keyboard layout, and switches between the configured ones.printingActive print jobs.removableRemovable drives.privacyMicrophone, camera, screen and location use.idleKeep your screen awake.sessionLog out, suspend, restart and shut down.

Workspaces and windows

pagerA strip of workspaces or windows, one slot each, that switches between them on a click.workspace-nameYour current workspace's name.trayApplication icons in the system tray.placesHome and user directories, bookmarks, network shares and the trash.

Information

clockThe time and date, with a calendar in its popover.next-eventThe next entry from the configured calendars.weatherCurrent weather and forecast.mprisMusic and playback controls.notificationsUnread notifications, with their history in its popover.

Tools

clipboardClipboard history.

Applets you build

commandYour own commands on the bar.execA third-party applet.

A command applet runs a program when you click or scroll on it. An exec applet is a program that draws its own indicator and popover. Their settings are on Command and exec applets.