lxpanel.hints(5)

💖 lxpanel.hints — bestie edition 💖

okay so this is the lxpanel.hints page from section 5 of the manual, and it's literally your group chat for lxpanel plugin config. sit down, grab a strawberry 🍓, we're doing this.

---

✨ NAME ✨

lxpanel.hints — configuration hints for lxpanel plugins 🎀

---

🌸 DESCRIPTION 🌸

so this text is a lil collection of background info for configuring the plugins that ship with lxpanel(1). think of it as the lore drop you need before you start editing your panel. 👑

the templates down below use the keywords boolean, integer, and string to show what type of value each instance expects. rn boolean only supports the values 0 and 1 — that's it, that's the whole menu, no true, no yes, no vibes. 🙈 a few exceptions further down use explicit values instead, just to make the common usage extra clear. the plugins get introduced by name in a semi-random fashion (we're not doing alphabetical, we're doing chaos, and honestly? iconic). in practice you write a mixture of different Plugin stanzas in the order that you want them to actually show up on the panel on your desktop. periodt. 💅

---

🦋 AVAILABLE PLUGINS 🦋

menu 🍓

Plugin {
    type = menu
    Config {
        name = string
        image = string

        system {
        }

        separator {
        }

        item {
            command = string
            image = string
        }
    }
}

dirmenu 📁

Plugin {
    type = dirmenu
    Config {
        name = string
        image = string
        path = string
    }
}

taskbar 🎀

Plugin {
    type = taskbar

    expand = integer
    LaunchTaskBarMode = integer
    Config {
        tooltips = boolean
        IconsOnly = boolean
        ShowAllDesks = boolean
        SameMonitorOnly = boolean
        UseMouseWheel = boolean
        UseUrgencyHint = boolean
        FlatButton = boolean
        GroupedTasks = boolean
        DisableUpscale = boolean
        UseSmallerIcons = boolean
        MaxTaskWidth = integer
        spacing = integer
    }
}

launchbar 🚀

Plugin {
    type = launchbar
    Button {
        image = string
        tooltip = string
        action = string
        path = string
        terminal = boolean
    }
    Button {
        id = lxde-logout.desktop
    }
}

wincmd 🪟

Plugin {
    type = wincmd
    Config {
        image = string
        Button1 = string
        Button2 = string
        Toggle = string
    }
}

space ⭐

Plugin {
    type = space
    expand = integer
    Config {
        Size = integer
    }
}

pager 🗂️

Plugin {
    type = pager
}

batt 🔋

Plugin {
    type = batt
    Config {
        BatteryNumber = integer
        HideIfNoBattery = boolean
        ShowExtendedInformation = boolean
        AlarmCommand = string
        AlarmTime = integer
        BorderWidth = integer
        Size = integer
        BackgroundColor = string
        ChargingColor1 = string
        ChargingColor2 = string
        DischargingColor1 = string
        DischargingColor2 = string
    }
}

kbled ⌨️

Plugin {
    type = kbled
    Config {
        ShowCapsLock = integer
        ShowNumLock = integer
        ShowScrollLock = integer
    }
}

dclock 🕰️

Plugin {
    type = dclock
    Config {
        ClockFmt = string
        TooltipFmt = string
        Action = string
        BoldFont = boolean
        IconOnly = boolean
        CenterText = boolean
    }
}

cpu 🧠

Plugin {
    type = cpu
}

cpufreq ⚡

Plugin {
    type = cpufreq
}

monitors 📊

Plugin {
    type = monitors
    Config {
        DisplayCPU = integer
        DisplayRAM = integer
        Action = string
        CPUColor = string
        RAMColor = string
    }
}

thermal 🌡️

Plugin {
    type = thermal
    Config {
        NormalColor = string
        Warning1Color = string
        Warning2Color = string
        Sensor = string
        AutomaticLevels = integer
        Warning1Temp = integer
        Warning2Temp = integer
        AutomaticSensor = integer
    }
}

deskno 🔢

Plugin {
    type = deskno
    Config {
        BoldFont = integer
        WMLabels = integer
    }
}

netstatus 📶

Plugin {
    type = netstatus
    Config {
        iface = string
        configtool = string
    }
}

xkb 🌈

Plugin {
    type = xkb
    Config {
        DisplayType = integer
        PerWinLayout = boolean
        NoResetOpt =  = boolean
        KeepSysLayouts = boolean
        Model = string
        LayoutsList = string
        VariantsList = string
        ToggleOpt = string
        AdvancedOpt = string
        FlagSize = integer
    }
}

not me noticing that double = on NoResetOpt — that's literally what the page says, bestie, so I'm handing it to you character for character. no edits, no cap. 💀

volume 🔊

Plugin {
    type = volume
    Config {
        MixerCommand = string
        MixerCommandTerm = boolean
        UseAlsamixerVolumeMapping = integer
        CardNumber = integer
        MasterChannel = string
        MuteButton = string
        SliderButton = string
        MixerButton = string
        VolumeUpKey = string
        VolumeDownKey = string
        VolumeMuteKey = string
    }
}

weather ☀️

Plugin {
    type = weather
    Config {
        alias = string
        city = string
        state = string
        country = string
        woeid = string
        units = string
        interval = integer
        enabled = integer
    }
}

---

🫶 CONFIGURATION FILES 🫶

• ~/.config/lxpanel/"profile-name"/panels/panel — your very own user-specific panel specification, main character energy ✨. the profile name gets passed to lxpanel with the switch --profile. and if you don't specify one? then the name "default" gets used. periodt.
• /etc/xdg/lxpanel/"profile-name"/panels/panel — the system default panel specification, which kicks in if no panels are defined in your user configuration directory. the backup bestie. 💜

---

👀 SEE ALSO 👀

lxpanel(1), lxpanelctl(1)

---

💀 BUGS 💀

there ought to be some, fr fr. do point them out! the Debian package maintainer will take the necessary steps and actions. so if you find one, say something, we're listening 🫶

---

🎀 AUTHOR 🎀

this text was compiled for Debian GNU/Linux by Mats Erik Andersson. it may be used also by others, but the text underlies the same licensing as lxpanel itself does. slay. 💅

---

okay that's the whole page, you're all caught up bestie 🌸 this was the lxpanel.hints(5) manual page, Linux, November 2016 — go forth and configure your panel, you absolute icon 👑✨