ICEWM-TOOLBAR(5)

💅 ICEWM-TOOLBAR(5) — the toolbar file, bestie ✨

okay so this is a page from the Standards, Environments and Macros manual set (ICEWM-TOOLBAR(5), iykyk) and it's literally all about making your icewm panel cute and functional 🎀

---

🌸 NAME 🌸

icewm-toolbar — the icewm toolbar configuration file. that's it, that's the vibe 💖

---

✨ SYNOPSIS ✨

here's every place your toolbar file can live, in order:

$ICEWM_PRIVCFG/toolbar
$XDG_CONFIG_HOME/icewm/toolbar
$HOME/.icewm/toolbar
/usr/etc/icewm/toolbar
/usr/share/icewm/toolbar

---

💫 DESCRIPTION 💫

so the toolbar file is the main character responsible for configuring those quick-launch application icons sitting pretty on the icewm(1) panel 🫶 it contains the names of apps you can launch fast, plus the icons for the task bar.

every non-empty, non-comment line starts with the keyword prog. after one or more spaces comes a name — and that name gets displayed in a tool tip whenever your mouse cursor hovers over the toolbar icon 🦋 this name may be a double quoted string. then comes the bare name of the icon to use, without extensions — that's the icon that'll show up in the toolbar. and the last component is a shell command line that gets executed whenever the user presses the icon in the toolbar 👑

for example, this line in toolbar creates a button with the tool tip "Mozilla Firefox", using the firefox icon, which launches firefox(1) when clicked:

prog  "Mozilla Firefox"  firefox  /usr/bin/firefox --private-window

no cap, that's the whole format. slay 🔥

---

🧚 FORMAT 🧚

the file's format contains one of the following line syntax:

prog "title" icon program options

where, bestie:

• prog — the literal string prog. that's literally it 💅
• "title" — the title of the toolbar item, which will appear as a tool-tip for the program button, enclosed in double quotes (""") 🎀
• icon — the icon to display on the toolbar button. may be specified as a single dash (-) when no icon is provided. when no icon is provided, the title text will be displayed on the button in place of the icon ✨ (ngl that's kind of a serve)
• program — the executable program (full path or executable name) to run when the button is pressed 👑
• options — options and arguments that are passed to program

lines beginning with a hash (#) are comment lines. comment lines and blank lines are ignored 🙈

⚠️ please note that all keywords from icewm-menu(5) are permitted here as well — yes, all of them. go off 💀

---

🌈 EXAMPLES 🌈

following is an example that places a number of toolbar buttons on the icewm(1) panel — look at her go 😭💖

prog "File Manager" file-manager.png pcmanfm
prog "Web Browser" web-browser.png /usr/lib/firefox/firefox
prog "Terminal" terminal.png roxterm
prog "Graphical Editor" text-editor.png gvim -f
prog "Calculator" accessories-calculator.png calculator
prog "Run Command" gtk-execute.png xde-run
prog "Network" gtk-network.png pcmanfm ~/Network
prog "Logout" system-log-out.png xde-logout

---

🍓 FILES 🍓

locations for the toolbar file are as follows, bestie:

$ICEWM_PRIVCFG/toolbar
$XDG_CONFIG_HOME/icewm/toolbar
$HOME/.icewm/toolbar
/usr/etc/icewm/toolbar
/usr/share/icewm/toolbar

the locations are searched in the order listed; the first file found is read and the remainder ignored 👀 so order matters fr fr.

---

🦋 SEE ALSO 🦋

icewm(1), icewm-programs(5), icewm-menu(5), icewm-menu-fdo(1) — go read those next, i'm obsessed 🌸

---

💜 AUTHOR 💜

Brian Bidulock <mailto:bidulock@openss7.org>. iconic behavior 💅

---

⭐ LICENSE ⭐

IceWM is licensed under the GNU Library General Public License. see the COPYING file in the distribution 📜

---

and that's the whole page, bestie 🫶 this was icewm 4.1.0, dated 2026-08-06, straight from the ICEWM-TOOLBAR(5) files — mwah 💋✨🎀