WMDRAWER(1)

🎀 WMDRAWER(1) — the manual page, but make it make sense 💅

okay bestie, this is a page from the General Commands Manual, and it's literally all about a little dockapp called wmdrawer. sit down, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

wmdrawer — a dockapp that hands you a drawer so you can launch your apps, no cap. 👑

---

🌈 SYNOPSIS 🌈

wmdrawer [-c, --configfile=FILE [-n, --instancename=NAME]]  [-w,
--windowed]  [-h, --help]  [-v, --version]

that's the whole vibe check. now let's unpack it 🫶

---

💖 DESCRIPTION 💖

so like. wmdrawer is a dock application (a "dockapp", iykyk) and what it does is give you a drawer — which is basically a retractable button bar — so you can launch applications in the most convenient way possible. iconic behaviour honestly.

the drawer is retractable and animated. it's giving main character energy.

you can define several columns of buttons inside the drawer. as many columns as your little heart desires.

the config file gets automatically reloaded if it changes — no restart required, we love a self-aware queen ✨

you can run multiple instances of the program at the same time. go off, run twelve of them, who's stopping you.

buttons can be highlighted under the mouse cursor so you always know what you're hovering.

you can define a tooltip for each button. little pop-up besties.

the drawer can be transparent — but heads up, that needs the SHAPE extension. no SHAPE, no see-through, sorry babe.

you've got the ability to launch several apps at once from the drawer. how? by holding down the key Shift, or by using mouse buttons middle or right instead of left — either way, the drawer stays open. periodt.

and now the adjustable behaviours, aka the settings menu of your dreams:

• the dock's image (its logo)
• the dock's width and height — for both of these, min=12, max=128
• automatic/manual opening and closing of the drawer
• the timeout value in milliseconds, used if automatic closing is selected
• the drawer's opening direction and animation speed
• the mouse cursor type in the drawer
• the drawer's pseudo-transparency
• the icons' background image — only if transparency isn't activated
• the buttons' size — min=12, max=128
• the buttons' highlight type — 0:none, 1:target, 2:shading
• the image used as highlight — target type only
• the color and darkening level for highlight — shading type only
• the drawer's border size
• the buttons' tooltips and the tooltips' font

---

🦋 OPTIONS 🦋

• -c, --configfile=FILE [-n, --instancename=NAME] — use FILE as the config file instead of the default (~/.wmdrawerrc), and optionally set the instance name. two-for-one, we love efficiency 💖
• -w, --windowed — run in windowed mode. this one's genuinely useful for AfterStep, Fvwm, Sawfish and KDE users. bestie-coded feature fr fr
• -h, --help — show a summary of the options. when in doubt, -h it out 🙈
• -v, --version — show the version of the program. know your queen's era 👑

---

🧚 FILES 🧚

~/.wmdrawerrc is the default per-user configuration file. and here — for you, specifically — is a completely commented example. every line, verbatim, no edits:

# Config file example for wmdrawer
[general]
# Dock's icon [optional]
#dock_icon      panel-drawer.png

# Drawer's opening direction [required]
# Top to bottom = 0
# Right to Left = 1
# Bottom to Top = 2
# Left to Right = 3
direction       2

# Image used for icons' background [optional]
#icons_bg       defaultTile.xpm

# Allow icons' enlargement to fit them to buttons' size [optional, default 1]
# 0 indicate that icons should never be larger than their original size.
#icons_expand   1

# Activate the drawer's pseudo-transparency [optional, default 0]
# if you choose transparency, icons_bg will be ignored
#transparency   0

# dock's width: min=12, max=128 [optional, default=64]
#dock_width     64

# dock's height: min=12, max=128 [optional, default=64]
#dock_height    64

# buttons' size: min=12, max=128 [optional]
# Useful for the people who want for example to have big icons
# and to define several columns.
#btns_size      32

# Icon's highlight type: 0, 1 or 2 [optional, default 2]
# 0 : no highlight
# 1 : target (unavailable if transparency is activated)
# 2 : shading
#highlight      2

# Image used as highlight [optional]
# only used if you choice target type
#highlight_img   highlight.xpm

# Tint icons by a specified color [optional, default #ffffff]
# only used if you choice shading type
#highlight_tint #ffffff

# Shade icons at a specified level [optional, default 60]
# only used if you choice shading type
#highlight_sh   60

# Display buttons' tooltips [optional, default 1]
#tooltips       1

# Tooltips' font [optional, default fixed]
#tooltips_font  fixed

# Drawer's animation speed: 0, 1, 2, 3, 4 [optional, default 1]
#animation_speed 1

# Mouse cursor in drawer: 0, 1, ..., 76 [optional, default 30]
#cursor         30

# Auto opening of the drawer: 0, 1 [optional, default 0]
#show_on_hover  0

# Auto closing of the drawer: 0, 1 [optional, default 0]
#hide_on_out    0

# drawer's hiding timeout in milliseconds [optional, default 1000]
#hide_timeout   1000

# Runs the dockapp in windowed mode: 0, 1 [optional, default 0]
# Useful for AfterStep, Fvwm, Sawfish or KDE users.
#windowed_mode  0

# Instance name so window manager can distinguish between multiple copies
#instance_name  distinguish_name

# Drawer's border size in pixels [optional, default 1]
#border_size    1

# Images directories
[images_paths]
/usr/share/pixmaps
/usr/local/share/pixmaps/

# A first column with 5 buttons
# Each button must be defined with this syntax:
# (tooltip)  (image)  (command)
[column]
(X Terminal)    (gnome-term.png)        (xterm -bg black -fg wheat)
(Galeon)        (galeon.xpm)            (galeon -s)
(Sylpheed)      (sylpheed.png)          (sylpheed)
(XChat)         (xchat.png)             (xchat)
(MPlayer)       (gnome-multimedia.png)  (mplayer)

# A second column with 5 buttons
[column]
(Xmms)          (gnome-audio2.png)      (xmms)
(Gimp)          (gnome-gimp.png)        (gimp)
(GQview)        (gqview.png)            (gqview)
(Xcalc)         (gnome-calc3.png)       (xcalc)
(GFtp)          (gftp.png)              (gftp)

and if you want a copy of this exact example just sitting on your disk, look at /usr/share/doc/wmdrawer/wmdrawerrc.example. it's right there, waiting for you 🫶

---

🌸 SEE ALSO 🌸

wmaker (1) — go say hi, it's the cousin ✨

---

💜 AUTHOR 💜

this software is written and maintained by Valéry Febvre (vfebvre@vfebvre.lautre.net). thank you for your service, king 👑

this manual page was written by Chris Wesley (chris@cwwesley.net) for the Debian system (but it may be used by others). permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation — with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. so basically: share it, remix it, keep those three conditions intact, slay.

---

⭐ OTHER INFO ⭐

wmDrawer's webpage lives at http://people.easter-eggs.org/~valos/wmdrawer/. that's where you go for info about wmdrawer and to download the latest version. go get it bestie 🌈

---

and that's the whole page!! mwah 💋 this was WMDRAWER(1), from the General Commands Manual, and it's signed off with the very same WMDRAWER(1) energy it started with — thanks for reading all the way to the bottom, you're literally the main character 🎀✨🦋