LXPanel

FromLXDE.org
LXPanelisthestandardpanelofLXDE.Thedesktoppanelcangenerateamenuforinstalled
applicationsautomaticallyfrom*.desktopfiles.ItcanbeconfiguredfromaGUIpreferences
dialog,sothereisnoneedtoeditconfigfiles.Thecomponentprovidesa"Run"dialogwith
autocompletion.Asofversion0.7.0,LXPanelhasgainedthemingsupportviacustomgtkrc
file.

LXPanel

Contents
1Importantnotes
1.1FileLocations
1.2MainConfigFile
1.3Panels
1.4Custommenupluginactions
1.5GNOMELikeTwoPanelLayout
1.6FixemptymenuinLXPanel
2TestingLXPanel
2.1Addresses
2.2Compilingoptions
3gxinemenuiconfix
4Iconsonly
5Seealso
6ExternalLinks

Developer

LXDETeam

Latest
version

0.8.1(from6May.2015)

Genre

DesktopPanel

License

GNUGeneralPublicLicense

Website

lxde.org(http://lxde.org/)

Importantnotes
Warning:Althoughlxpanelisoriginallyderivedfromfbpanel,theyarenowalmosttotallydifferentbothininternalimplementationand
configuration.So,don'tusefbpanelconfigfileshereorthingswillbreak.
BasicconfigurationofLXPanelcanbedonewiththeGUIpreferenceconfigurationdialog.Justrightclickonthepanels,andyoucan
accesstheconfigdialog.PleaseusetheGUIinsteadofdirectlyeditingtheconfigfilesifyoudon'thaveveryspecialneeds.
Theformatofconfigfileshaschangedsinceversion3.5tosupportmultiplepanellayout.Don'tmixolderconfigfileswithnewer
versions.
Theconfigfileformatwasnotdocumentedbeforeversion3.7becauseitwasnotyetstabilized.Now,it'sdocumentedhere.

FileLocations
TheconfigfilesofLXPanelarestoredin~/.config/lxpanel/<ProfileName>.
UnderLXDE,weuseadifferentprofilenameLXDE.Soit'sin~/.config/lxpanel/LXDE.Inthisway,ifyouchangedtheconfigofthe
panelunderLXDE,itwon'tinterfereotherdesktopenvironments.
Iftheconfigfilesaremissing,lxpanelloadssystemwideconfigin/usr/share/lxpanel/profile/<Profilename>instead.

MainConfigFile
Themainconfigfileisnamed"config",anditsformatislikethis:
[Command]
FileManager=pcmanfm%s
Terminal=xterme
LogoutCommand=

FileManager
filemanagerusedwhenanappletinlxpanelneedtoopenafolder(onlybeforeversion0.7.0,since0.7.0itusesXDGpreferences).
Terminal
terminalemulatorusedwhenanappletneedstopopupaterminalwindow(onlybeforeversion0.7.0,since0.7.0itusesLibFMconfig).
Logout
programinvokedwhen"Logout"ischoseninthelxpanelmenu.Generally,thiscanbe"killall<something>".UnderLXDE,youcanuse
"lxdelogout"tologoutthesession.Warning:priortolxpanelversion0.5.10itseemsthatitwas"LogoutCommand"insteadof
"Logout".

Panels
Filesdefiningthelayoutofpanelsarein~/.config/lxpanel/<Profile>/panels.Eachfileinthedirectorydefinesapanel.Onstartup,allpanels
definedinthosefilesareloaded.Thedefaultconfigfilelookslikethis:
#lxpanel<profile>configfile.Manuallyeditingisnotrecommended.
#Usepreferencedialoginlxpaneltoadjustconfigwhenyoucan.
#Globalsection:definesappearanceandbehaviorofthispanel.
Global{
edge=bottom#Theedgethispanelattachesto
allign=left#alignment:left/center/right
margin=0#margin:margintotheedgeofthewholescreen

widthtype=percent#percent/pixel
width=100#widthofthepanel:Theunitusedhereisaccordingtowidthtype.
height=26#heightofthepanel
transparent=0#use(pseudo)transparentbackground:on=1,off=0
tintcolor=#000000#colorblendedwiththebackgroudwhentransparencyisused.
alpha=0#alphavalueusedtoblendtintcolorwithbackground.
setdocktype=1#askthewindowmanagertotreatthepanelasadock.
setpartialstrut=1#askthewindowmanagertoreservethespaceforthepanelandnottocoveritwithmaximizedwindows
usefontcolor=1#usecustomizecolorsforthetextinsteadofthatdefinedinsystemtheme.
fontcolor=#ffffff#coloroftextonthepanel(Currentlythisisonlysupportedbyclockapplet)
background=1#usecustomizeimagetodrawthebackgroundofthepanel.(cannotbeusedwithtransparent)
backgroundfile=/usr/share/lxpanel/images/background.png#Theimagefileused.
}
#Configurationofvariousapplets
#Basicsyntax:
#Plugin{
#type=<plugintype>
#expand=0(optional,mainlyusedin"taskbar"and"space"applets.
#expand=1willstretchtheapplettofillallavailablespaces)
#Config{
#...
#}
#}
Plugin{
type=space
Config{
Size=2
}
}
Plugin{
type=menu
Config{
#imagemustbeset
image=/usr/share/lxpanel/images/mycomputer.png
#nameisoptional
#itmaybesettothenameofa*.directoryfilein/usr/share/desktopdirectoriestogetalocalisedlabel
#eg.name=lxdemenuapplications.directory
name=Label
#tintmaybesettoanX11colournameorahexvalue,
#seehttp://library.gnome.org/devel/gdk/unstable/gdkColormapsandColors.html#gdkcolorparse
#Thedefaultisblue;blackdisablestinting.
tint=red
system{
}
separator{
}
item{
command=run
}
separator{
}
item{
image=gnomelogout
command=logout
}
}
}
Plugin{
type=launchbar
Config{
Button{
id=pcmanfm.desktop
}
Button{
id=gnometerminal.desktop
}
Button{
id=firefox.desktop
}
}
}
Plugin{
type=space
Config{
Size=4
}
}
Plugin{
type=wincmd
Config{
Button1=iconify
Button2=shade
}
}
Plugin{
type=space
Config{
Size=4
}
}
Plugin{
type=pager
}
Plugin{
type=space
Config{
Size=4
}
}
Plugin{

type=taskbar
expand=1
Config{
tooltips=1
IconsOnly=0
AcceptSkipPager=1
ShowIconified=1
ShowMapped=1
ShowAllDesks=0
UseMouseWheel=1
UseUrgencyHint=1
FlatButton=0
MaxTaskWidth=150
spacing=1
}
}
Plugin{
type=netstat
}
Plugin{
type=cpu
}
Plugin{
type=tray
}
Plugin{
type=dclock
Config{
ClockFmt=%R
TooltipFmt=%A%x
BoldFont=0
}
}

Custommenupluginactions
UndertheMenupluginentryshownabove,customentriescanbeaddedusingtheaction=setting.Forexample:
item{
image=boot
name=Exit
action=lxdelogout
}

(Thisshouldnotbeconfusedwiththemainmenuspecificationfromfreedesktop.orgimplementedvia*.desktopfilesin/usr/share/applications
)

GNOMELikeTwoPanelLayout
LXPanelcansupportmultiplepanellayouts.Weprovideasetofconfigurationfilesthatmimicthedefaultlookandfeelofagnomeliketwo
panellayouthere.http://lxde.git.sourceforge.net/git/gitweb.cgi?p=lxde/lxpanela=treef=data/two_panelshb=HEAD

FixemptymenuinLXPanel
Ifyouclickonthemenubutton,butthemenudoesn'tcomeup,youcanusethislittlescripttofixit:
#!/bin/bash
killalllxpanel
find~/.cache/menusname'*'typefprint0|xargs0rm
lxpanelpLXDE&

Itwillkilllxpanel,deletethecurrentmenucacheandstartthepanelagain.Testedwith0.3.99/0.3.999.

TestingLXPanel
HereyoucanfindthespecialInformationforLXPanel.IfyouwanttousethemenupluginwithinLXPanel,youneedtocompileapplications
menucacheandlxmenudatatoo.Firstcompilemenucache,thenlxmenudataandatlastLXPanel.Forgeneralinformationontestingread
theTesting(http://wiki.lxde.org/en/Category:Testing)pages.

Addresses
Sourcebrowser:http://git.lxde.org/gitweb/?p=lxde/lxpanel.gita=summary
SourceGit:git://git.lxde.org/lxde/lxpanel.git
Bugstracker:http://sourceforge.net/p/lxde/bugs/

Compilingoptions
./autogen.sh
./configure
make
makeinstall

you'llneedmenucachefromtheLXDErepositorytocompileLXPanel.

gxinemenuiconfix
Openfile/usr/share/applications/gxine.desktop:
#nano/usr/share/applications/gxine.desktop

Deletelines:
xcontent/videosvcd
xcontent/videovcd

Change"Categories"value:
Categories=AudioVideo;Player;TV;

gxineisplacedinthemenunow.

Iconsonly
Itispossibletochangethepanelappearancetoaveryminimaliststyle,similartotint2,displayingonlyiconsratherthantabs.Todothis,open
panelsettings(e.g.rightclickingonthe"desktops"partofthepanel)and:
choosePanelAppletstab
fromthelist,choose"TaskBar(WindowList)"
clickedit
togetjusttheiconsagainstthebackgroundofthepanel,selectboth"Iconsonly"and"Flatbuttons"
"Showtooltips"and"Showwindowsfromallworkspaces"optionsarealsoavailableonthePanelAppletstab.
Toadjusticonsizeaswellaspanelwidthandheight,seetheGeometrytabinsettings.Thethicknessofthebarandthesizeoftheiconsareset
separately.

Seealso
HowtowritepluginsforLXPanel
MainMenu
LXPanelTheming

ExternalLinks
LXPanelatsf.net(http://sourceforge.net/projects/lxde/files/LXPanel%20%28desktop%20panel%29/)
LXDE:ConfiguringLXPanel(http://pclosmag.com/html/Issues/201010/page07.html)PCLinuxOSMagazinedetailedconfiguration
instructions.
Retrievedfrom"http://wiki.lxde.org/en/index.php?title=LXPanel&oldid=24171"
Categories: LXDE Component
Thispagewaslastmodifiedon9May2015,at00:17.
Thispagehasbeenaccessed238,677times.
ContentisavailableunderGNUFreeDocumentationLicense1.2unlessotherwisenoted.