MAKEASTHEME(1x)

💖 MAKEASTHEME — the makeastheme / installastheme manual page, but make it cute 💖

okay bestie, welcome to MAKEASTHEME(1x) — yes that's the real manual section name, we're keeping it, she's iconic 🎀

---

✨ NAME ✨

makeastheme, installastheme — the little duo that manages themes in the Afterstep window manager. slay 💅

---

✨ SYNOPSIS ✨

makeastheme [--theme <theme_name>] [--no_wharf] [--no_pager]
[--no_winlist] [--no_background]

installastheme [--theme <theme_name>] [--no_wharf] [--no_pager]
[--no_winlist] [--no_background]

---

🌸 DESCRIPTION 🌸

so basically this bundle of two Perl scripts is what implements themes in the AfterStep window manager for X (http://www.afterstep.org). no cap, that's the whole job 🦋

rnnn these scripts are becoming solid beta quality. but bestie, I would still highly recommend you back up your configuration files in the ~/.afterstep dir. the easiest way to undo a theme is to simply restore your old files. that's it, that's the escape hatch 🙈

This theme pack currently supports the following modules and options:

• Wharf:
  • BgColor
  • Pixmap
  • TextureColor
  • TextureType
• WinList:
  • Font
  • Fore
  • Back
  • Justify
  • Pixmap (AS 1.5b6 pl2)
• Pager:
  • Align
  • Back
  • BalloonBack
  • BalloonBorderColor
  • BalloonBorderWidth
  • BalloonFore
  • DesktopImage
  • Font
  • Hilight
  • Image
  • SmallFont

Of course, the look file and desktop background is supported. Also, any images specified in the look file or the module options above are also carried with the theme that is built. 💫

This theme pack expects to find the ~/.afterstep/desktop/themes directory. Each theme should be a subdirectory from there. When you download a theme, untar it in the themes dir. Also, when you build a theme, if you want to bundle any unique icons for use in the database file, put them in the specific subir of the themes dir. 📁

Also, the theme pack will only look in ~/.afterstep for module configuration files. That means when building a theme, it only takes modifications from that dir. If the config files aren't there, makeastheme will ignore that module. When installing a theme, installastheme will only edit files in ~/.afterstep. If it doesn't find any modules there, it will skip that module. At a minimum, you should have 'wharf', 'pager', and 'winlist' files in the ~/.afterstep dir. 👑

---

💅 OPTIONS 💅

Both installastheme and makeastheme take the same command line, which can be in any order. The directory from which the scripts are called is irrelevant. All directory paths are coded into the scripts and double-checked at runtime. After running installastheme, you will need to manually restart AfterStep for the changes to take place. like, actually restart it, fr fr 😤

When making the themes, you simply run makeastheme with the --theme <theme_name> argument and any of the other command line arguments you might want to use. This script will grab all the config files necessary and all images specified within those config files. It then creates the theme in your '~/.afterstep/desktop/themes' 🌈

• --theme — this option is used to specify the theme to install. With installastheme it is mandatory. With makeastheme if unspecified, the $USER environmental variable will be used instead. (not me letting $USER pick my theme, but okay 💀)
• --no_wharf, --no_pager, --no_winlist, --no_background — Each of these options tell the scripts to skip processing for each of these modules. For makeastheme it is similar to saying, "I don't have anything interesting in this module, don't store those options in the theme." For installastheme it is similar to saying, "I really like my module, don't change any settings in there."

---

🦋 SEE ALSO 🦋

afterstep(1x), Pager(1x), Wharf(1x), WinList(1x), /usr/share/doc/afterstep/README.theme.handler.gz .

go read those too, iykyk 🫶

---

👑 AUTHORS 👑

These tools were written by Lathi <alcornd@earthlink.net>.

This manual page was written by Robert Luberda <robert@debian.org>, based on the README.theme.handler file, for the Debian GNU/Linux system (but may be used by others). ✨

---

💀 BUGS 💀

If you find any, you can email me (mailto:alcornd@earthlink.net) or the AfterStep mailing list (mailto:afterstep@linuxcenter.com). Alternatively, you can also probably find me on EfNet channel #afterstep as Lathi. 🙈

---

and that's the whole page bestie!! 🎀 this one's dated Feb 10th, 2008 and it's the MAKEASTHEME(1x) manual, so if you see those exact words floating around at the bottom of a terminal somewhere, that's just this girl's little signature. love her, she ate. periodt 💖