aewm++_appbar(1)

✨ aewm++_appbar(1) ✨

okay bestie, welcome to the General Commands Manual page for aewm++_appbar(1) 💖 it's giving tiny launcher energy, let's get into it 🧚

✨ NAME ✨

aewm++_appbar — a small application launcher 🚀

✨ SYNOPSIS ✨

aewm++_appbar

✨ DESCRIPTION ✨

okay so appbar is a small application launcher 🦋 it uses tiny 16x16 pixmaps as icons so you can launch your fave programs super fast. main character behavior, literally 💅

NOTE: ngl this one's important ⚠️ right now, using any other pixmap size gives unwanted behavior. the appbar main window won't place those icons properly, and that's a whole vibe-killer 💀

to change the list of icons, you edit the file /etc/X11/appbar/appbar.rc 🍓

the install process drops some pixmaps into /usr/share/appbar/images/ 🌸 these are 16x16 pixmaps made for use with the appbar. they were downloaded from http://wm-icons.sourceforge.net/data/wm-icons-current/icons/16x16-general/ and they are GPL'd 🫶

✨ RC FILE SYNTAX ✨

the resource file syntax is super simple, I promise 🥹 a definition of an icon looks like this:

Use vertical_placement or horizontal_placement to customize the appbar look 💖

icon {
     image = images/terminal.xpm;
     execute = xterm -bg black -fg white -ls;
}

inside the icon construct you get two extra variables 🎀 the first one is the name of the image, followed by an equals sign, then the path and filename of the xpm, then a semi-colon.

the second variable is execute. its syntax is basically the same as images. the only difference is that you put the path to the executable you want this icon to launch when it gets clicked 🔥

for appbar placement, use these commands in the rc file:

Appbar Style
     vertical_placement
     horizontal_placement

Appbar Screen Placement
     northwest_placement
     northeast_placement
     southwest_placement
     southeast_placement

want a different background gradient for the appbar? same energy, just use these:

appbar_color_from {
     red=99;
     green=99;
     blue=99;
}

appbar_color_to {
     red=cc;
     green=cc;
     blue=cc;
}

NOTE: image and execute variables end with a semi-colon 💅 and the icon construct gets enclosed in braces. don't forget 🙈

Usage: appbar is extremely simple to use 🥰 click an icon and it launches the app it's linked to. click the grill (over at the right edge) and it shades the window up to the upper left corner. click it again and it unshades back to its original size. middle-click the grill and it closes the application 💀✨

Gradient Theme: appbar borrows blackbox's image gradient code 🌈 you can only switch to a different color theme by editing appbar.cc in the appbar constructor. iykyk 👑

Default icon: appbar uses a default icon taken from fspanel, and full credit goes to its author 🙌 this icon is a fail-safe backup, in case the requested icon can't be found 🧸

✨ RC FILE EXAMPLE ✨

here's a full rc file so you can see how it all slots together 🦋

vertical_placement
northwest_placement

appbar_color_from {
     red=99;
     green=99;
     blue=99;
}

appbar_color_to {
     red=cc;
     green=cc;
     blue=cc;
}

icon {
     image = /usr/X11/share/appbar/images/terminal.xpm;
     execute = xterm -bg black -fg white -ls;
}

icon {
     image = /usr/X11/share/appbar/images/netscape.xpm;
     execute = /opt/mozilla/./mozilla;
}

✨ AUTHOR ✨

appbar is supplied with aewm++ by Frank Hale <frankhale@yahoo.com> 💜

appbar was renamed to aewm++_appbar for the Debian package 🌈

✨ WEBSITE ✨

http://sapphire.sourceforge.net/ 🌸

---

and that's the whole tea, bestie 🫶 the footer says aewm++_appbar(1) again, because we always end where we started 💅✨