Skip to content

System applets ​

These applets show and control the hardware and system services: sound, connections, displays, power and the session. Most of them need a system service to be installed; Install lists which.

Some applets also have a table named after the service behind them, shown after the applet's own. The service table changes the service for everything that uses it; the applet table changes only that applet.

audio ​

[applets.audio]

Speaker and application volume.

scroll-stepinteger from 1 to 100 default 5

How much one scroll notch on the speaker icon changes the volume, in percent, from 1 to 100.

tooltip-formatstring default "{volume}"

What the bar's tooltip reads. {volume} is the volume in percent, or Muted.

Screenshot
The audio popoverThe audio popover

bluetooth ​

[applets.bluetooth]

Bluetooth and paired devices.

devicesinteger default 6

How many disconnected paired devices you see before a "more devices" row. Connected devices don't count.

nearbyinteger default 8

How many nearby devices the popover lists while scanning.

tooltip-formatstring default "{status}"

Your tooltip text, with {status} for connection status, {devices} for connected devices and {adapter} for your Bluetooth adapter's name.

Screenshot
The bluetooth popoverThe bluetooth popover
[bluetooth]
hide-unnamedboolean default true

Hide nearby Bluetooth devices that have no name.

scan-timeoutinteger default 30

How many seconds you scan for nearby Bluetooth devices. With 0, scanning continues until you close the popover.

network ​

[applets.network]

Your network connections.

Your tooltip text, with {connection} for your network, {metered} for its metered status, {signal} for Wi-Fi strength and {vpn} for your VPN's name.

Default
{connection}
{metered}
Signal {signal}%
VPN: {vpn}
visible-networksinteger default 8

How many other networks you see before a "more networks" row; 0 shows all. Connected and saved networks don't count.

vpn-chipboolean default true

Show your active VPN as a separate icon beside your network icon.

Screenshot
The network popoverThe network popover
[network]
hide-unnamedboolean default true

Hide networks that don't broadcast a name.

scan-timeoutinteger default 30

How many seconds you scan for nearby networks. With 0, scanning continues until you close the popover.

display ​

Works withniriHyprland

[applets.display]

Displays, brightness and night light.

scroll-stepinteger from 1 to 100 default 5

How much scrolling one notch changes your display's brightness, in percent, from 1 to 100.

tooltip-formatstring default "{name}: {brightness}%"

Your tooltip text, with {name} for the display's name and {brightness} for its brightness percentage.

Screenshot
The display popoverThe display popover
[brightness]
ddcboolean default true

Control the brightness of your external monitors. Changes apply after you restart the panel.

minimuminteger from 0 to 100 default 3

The lowest brightness percentage your display can reach, from 0 to 100. Your keyboard backlight can still reach 0.

power ​

[applets.power]

Battery, power mode, keep awake and peripheral batteries in its popover.

indicator-styleone of default "icon-only"

Whether the bar shows the battery icon, the label, or both.

  • "icon-only"
  • "icon-text"
  • "text"
label-formatstring default "{percentage}"

What the label shows. Placeholders are replaced by name: {percentage}, {state} and {remaining}, the time left to empty or full.

tooltip-formatstring default "{state} · {percentage}"

What the bar's tooltip reads. {percentage}, {state} and {remaining}, the time left until empty or full.

Screenshot
The power popoverThe power popover

keyboard ​

Works withniriHyprland

[applets.keyboard]

The active keyboard layout, and switches between the configured ones.

tooltip-formatstring default "{name}"

Your tooltip text, with {code} for the short layout label and {name} for its full name.

Screenshot
The keyboard popoverThe keyboard popover
[keyboard]
labelstable of strings default {}

Your layout labels, matched by code or full name without regard to case, such as { "English (US)" = "EN" }. Other layouts show their code.

rememberone of default "window"

Keep a keyboard layout for each window, each app, or everything with global.

  • "global"
  • "app"
  • "window"

printing ​

[applets.printing]

Active print jobs.

jobsinteger default 8

How many active print jobs you see.

showone of default "jobs"

When the bar shows the printing chip.

  • "always" Show whenever a printer exists.
  • "jobs" Show while a print job is active.

Your tooltip text, with {document} for the current document, {printer} for its printer, {pages} for progress and {count} for the jobs shown.

Default
{document}
{printer}
{pages}
Screenshot
The printing popoverThe printing popover
[printing]

removable ​

[applets.removable]

Removable drives.

tooltip-formatstring default "Removable"

What the bar's tooltip reads. {drives} and {volumes} are how many of each are attached.

volumesinteger default 6

How many devices (drives, not their volumes) the popover lists before the rest go behind a drawer.

Screenshot
The removable popoverThe removable popover
[removable]
capacity-intervalinteger default 10

How often free space on removable drives is checked, in seconds. Use 0 to hide the free-space reading.

privacy ​

[applets.privacy]

Microphone, camera, screen and location use.

show-cameraboolean default true

Whether the camera is shown when in use.

show-locationboolean default true

Whether location access is shown when in use.

show-microphoneboolean default true

Whether the microphone is shown when in use.

show-screencastboolean default true

Whether screen capture is shown when in use.

tooltip-formatstringnot set by default

What the bar's tooltip reads. Plain text. Unset names what is in use and by which app.

Screenshot
The privacy popoverThe privacy popover

idle ​

[applets.idle]

Keep your screen awake.

tooltip-formatstring default "{status}"

Your tooltip text, with {status} for what is keeping your screen awake.

Screenshot
The idle popoverThe idle popover

session ​

[applets.session]

Log out, suspend, restart and shut down.

tooltip-formatstring default "Session"

Your tooltip text, with {user} for your user name.

Screenshot
The session popoverThe session popover

Released under the BSD 3-Clause license.