Applets

Clock

Clock
[[panel.applet]]
    name = "clock"
    format = "%X"
    [panel.applet.font]
        family = ""
        style = "normal"
        weight = "bold"
        size = -1
        strikethrough = false
        underline = "none"
        letter_spacing = -1

-1 or “” means the default setting. Basically all of this is setted to default and applet will be alive without this config.

Parameter

Description

Content

format

strftime format string

Any strftime-compliant string

font.family

A font familiy

Any font in your pc e.g. ‘Comic Sans’

font.style

Style of the font

normal, oblique or italic

font.weight

Weight of the font

thin, ultrathin, semilight, book, normal, medium, semibold, bold, ultrabold, heavy, ultraheavy

font.size

Size of the font

Any positive integer or -1 for default value

font.strikethrough

You know what that means.

true or false

font.underline

Underline.

none, single, double, low, error

font.letter_spacing

Spacing between letters

Any positive integer or -1 for default value

GTK and CSS structure:

GtkButton[(.|#)clock(-id)]
| - GtkLabel
GtkPopover[(.|#)clock-popover(-id)]
| - GtkCalendar

Separator

[[panel.applet]]
name = "separator"
stretch = true
margin_start = 0
margin_end = 0

This is the default config of separator applet. All you need to know is, stretch extends applet to fill all of the panel, margin_start and margin_end changes margins of applet.

Task switcher

Task switcher
[[panel.applet]]
name = "task-switcher"
    [panel.applet.mode.scroll]
    fallback_icon = "application-x-executable"
    expand = true
    minimum_windows_per_row = 6
    maximum_windows_per_row = 12
        [panel.applet.mode.scroll.button]
        icon_only = false
        gap = 8
        flat = false
        icon_height = -1

This text above is default settings. You can ommit all of this but name must be present. -1 means automatic option.

Parameter

Description

Content

mode.scroll.fallback_icon

Fallback icon if applet can’t find any.

Text

mode.scroll.expand

If applet should expand to fill as much space as possible.

true/false

mode.scroll.minimum_windows_per_row

Minimum window buttons per task bar row.

Integer

mode.scroll.maximum_windows_per_row

Maximum window buttons per task bar row.

Integer

mode.scroll.button.icon_only

If only icon should be presented on button.

true/false

mode.scroll.button.gap

Gap between icon and window title.

Integer

mode.scroll.button.flat

If button should be without shadows.

true/false

mode.scroll.button.icon_height

Height of icon.

Integer

GTK and CSS structure:

GtkScrolledWindow[(.|#)task-switcher(-id)] // Window list
| - GtkFlowBox
| | - GtkFlowBoxChild
GtkFlowBoxChild  // Single window button
| - GtkToggleButton
| | - GtkBox
| | | - GtkImage
| | | - GtkLabel
GtkMenu[(.|#)task-switcher-context-menu(-id)]
| ...

Activator

Activator
[[panel.applet]]
    name = "activator"
    flat = false
    icon_height = -1

    [[panel.applet.activator]]
        type = "application"

        name = "Screenshooter"
        description = "You know what this means"
        icon = "application-x-executable"

        command = "<SOME SCREENSHOOTER APP>"
        working_directory = ""

    [[panel.applet.activator]]
        type = "hypertext"

        name = "Wapanel repository"
        description = "Shortcut to wapanel's repository"
        icon = "application-x-executable"

        url = "https://github.com/firstbober/wapanel"

This text above is default settings. You can ommit all of this but root name must be present. -1 means automatic option.

Parameter

Description

Content

flat

Should activator buttons be flat.

true/false

icon_height

Height of the icon in activator.

Integer

activator.type

Type of activator.

Text(application/hypertext)

activator.name

Name of activator.

Text

activator.description

Description of activator.

Text

activator.icon

Icon of activator.

Text

activator.command

Command that activator should execute.

Text

activator.working_directory

Working directory of executed command.

Text

activator.url

URL of website.

Text

GTK and CSS structure:

GtkBox[(.|#)activator(-id)]
| - GtkButton
| | ...
| - GtkMenuButton
| | - GtkPopover[(.|#)activator-popover(-id)]
| | | - GtkButton
| | | | ...
| | | ...
GtkButton
| - GtkImage
| - GtkLabel

Volume control

Volume control
[[panel.applet]]
    name = "volume-control"
    flat = false
    icon_height = -1
    sound_mixer = ""

This text above is default settings. You can ommit all of this but root name must be present. -1 means automatic option.

Parameter

Description

Content

flat

Should activator buttons be flat.

true/false

icon_height

Height of icon on panel.

Integer

sound_mixer

Command to execute using Sound Mixer.

Text

GTK and CSS structure:

GtkMenuButton[(.|#)volume-control(-id)]
| - GtkImage
GtkPopover[(.|#)volume-control-popover(-id)]
| - GtkBox
| | - GtkBox // Volume control
| | - GtkBox // Volume control
GtkBox // Volume control
| - GtkImage
| - GtkScale
| - GtkSwitch

App finder

App finder
[[panel.applet]]
    name = "app-finder"

    icon = ""
    icon_height = -1
    flat = false

    popover_width = -1
    popover_height = -1

    user_manager = ""
    settings = ""
    file_manager = ""

    [panel.applet.logout]
        shutdown = ""
        restart = ""
        logout = ""
        suspend = ""
        hibernate = ""
        lock = ""

This text above is default settings. You can ommit all of this but root name must be present. -1 means automatic option.

Parameter

Description

Content

flat

Should activator buttons be flat.

true/false

icon_height

Height of icon on panel.

Integer

icon

Icon of button.

Text

popover_width

Width of app finder popover.

Integer

popover_height

Height of app finder popover.

Integer

user_manager

Executable name of account settings.

Text

settings

Executable name of system settings.

Text

file_manager

Executable name of file manager.

Text

Logout popover:

Parameter

Description

Content

shutdown

Shutdown command.

Text

restart

Restart command.

Text

logout

Logout command.

Text

suspend

Suspend command.

Text

hibernate

Hibernate command.

Text

lock

Lock command.

Text

GTK and CSS structure:

GtkMenuButton[(.|#)app-finder(-id)] // Button on panel
| - GtkImage
GtkPopover[(.|#)app-finder-popover(-id)] // Popover after click
| - GtkBox
| |
| | - GtkBox // Sidebar with file manager etc.
| | |
| | | - GtkButton // User settings button
| | | | - GtkImage
| | | |
| | | - GtkBox // Container with action buttons
| | | |
| | | | - GtkButton // Settings button
| | | | | - GtkImage
| | | |
| | | | - GtkButton // File manager button
| | | | | - GtkImage
| | | |
| | | | - GtkButton // Logout button
| | | | | - GtkImage
| | | |
| | |
| |
| | - GtkBox // App list and categories
GtkBox // App list and categories
| - GtkStack
| |
| | - GtkNotebook[(.|#)app-finder-category-notebook(-id)]
| | |
| | | - GtkScrolledWindow[(.|#)app-finder-category-app-list(-id)]
| | | | - GtkViewport
| | | | - GtkListBox
GtkPopover[(.|#)app-finder-popover(-id)] // Popover popped after logout button
| - GtkButton // Some action eg. logout
| |
| | - GtkBox
| | | - GtkImage
| | | - GtkLabel
| | |
| |
| ... // More buttons