Skip to content
NoctaliaNoctaliadocs

    FAQnoctalia.dev

    Shortcuts

    The Home tab displays a row of shortcut buttons at the bottom. Up to 6 shortcuts are shown. You can configure the list in TOML or edit it from Settings -> Control Center.

    [[control_center.shortcuts]]
    type = "wifi"
    

    [[control_center.shortcuts]]
    type = "bluetooth"
    

    [[control_center.shortcuts]]
    type = "nightlight"
    

    [[control_center.shortcuts]]
    type = "notification"
    

    [[control_center.shortcuts]]
    type = "wallpaper"
    

    [[control_center.shortcuts]]
    type = "session"

    When no [[control_center.shortcuts]] entries are defined, the default set is: wifi, bluetooth, caffeine, nightlight, notification, power_profile. Set shortcuts = [] under [control_center] to hide all Home shortcut buttons.

    Use show_shortcut_labels under [control_center] to show or hide the text under each shortcut icon (default true). When labels are off, the icons scale with the shortcut cell size, which is useful at narrower Control Center widths.

    [control_center]
    show_shortcut_labels = false

    Entry Fields

    Section titled “Entry Fields”
    FieldTypeDefaultDescription
    typestringrequiredShortcut type from the list below

    Types

    Section titled “Types”
    TypeLabelBehaviorRight-click
    wifiWi-FiToggle wireless on/offOpen network tab
    bluetoothBluetoothToggle adapter on/offOpen bluetooth tab
    nightlightNight LightToggle blue-light filter (forced -> scheduled-on)Toggle always-on (force)
    notificationDNDToggle Do Not DisturbOpen notifications tab
    dark_modeDark ModeToggle light/dark theme-
    caffeineCaffeineToggle idle/sleep prevention-
    audioAudioToggle output muteOpen audio tab
    mic_muteMicrophoneToggle mic muteOpen audio tab
    power_profileCurrent profileCycle power profileOpen system tab
    mediaMediaPlay/Pause active playerOpen media tab
    weatherTemperatureOpen weather tabOpen weather tab
    systemSystemOpen system tabOpen system tab
    screen_timeScreen TimeOpen screen time tabOpen screen time tab
    keyboard_layoutCurrent layoutCycle keyboard layout-
    screen_recorderRecorderToggle recordingToggle replay buffer
    wallpaperWallpaperOpen wallpaper panel-
    sessionSessionOpen session panel-
    clipboardClipboardOpen clipboard panel-

    Dynamic Shortcuts

    Section titled “Dynamic Shortcuts”

    Toggle shortcuts show an active/inactive visual state. power_profile, weather, and keyboard_layout display dynamic labels such as the current power profile, temperature, or keyboard layout.

    weather is available only when [weather].enabled = true. system is available only when [system.monitor].enabled = true. screen_time is available only when [shell].screen_time_enabled = true.

    screen_recorder requires the official noctalia/screen_recorder plugin to be enabled; without it the shortcut stays disabled.

    Section titled “Related IPC”

    Many shortcut buttons trigger the same canonical IPC commands documented elsewhere: