lxpanel.hints

Section: (5)
Updated: November 2016
Index Return to Main Contents

Name

lxpanel.hints - Configuration hints for lxpanel plugins

Description

This text collects some background information for configuration of plugins available for lxpanel(1).

The templates below use keywords boolean, integer, and string to denote the expected type of value for each instance. Currently boolean supports only 0 and 1 values. A few exceptions below are using explicit values in order to clarify the common usage. The plugins are introduced by name in a semi-random fashion. In practice a mixture of different stanzas Plugin are written in the order that they are to produce in the actual panel on the desktop.

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
    }
}

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: User specific panel specification. The name of the profile is passed to lxpanel using the switch '--profile'. If none specified then name "default" will be used.
/etc/xdg/lxpanel/"profile-name"/panels/panel: System default panel specification if no panels are defined in user configuration directory.

Bugs

There ought to be some. Do point them out! The Debian package maintainer will take necessary steps and actions.

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.

This document was created by man2html, using the manual pages.
Time: 13:49:17 GMT, April 23, 2024