afterstep_faq(7x)

💖 NAME 💖

afterstep_faq — bestie, this is literally an ever growing set of questions, statements, ideas and complaints about AfterStep version 2.0. she grows, she evolves, she never stops. 💅

---

🌈 1. General Information 🌈

🎀 1.1. About this Document. 🎀

okay so first thing first — this document is an ever growing set of questions, statements, ideas and complaints about AfterStep version 2.0. yes, complaints too. we accept all vibes here. 🫶

you can grab this FAQ from the following locations:

• http://www.afterstep.org/

and heads up: the rest of this doc assumes you're running AfterStep 2.0. if you're on a version of AfterStep prior to 2.0, this document suggests exactly one thing, and it's: upgrade. that's the whole tip. that's it. ⭐

🦋 1.2. What is AfterStep? 🦋

AfterStep is a Window Manager for the X Window System (from here on out we're just gonna call it X, iykyk). it was started to emulate the look and feel of NeXTSTEP(tm), but then it evolved into something that — while still being able to emulate NeXT — can do much much more. ✨

and the flex? without using much memory or cpu time, AfterStep provides all the features one could want in a Window Manager. main character energy, fr fr. 👑

💜 1.3. What is AfterStep's history? 💜

okay storytime 📖. the original AfterStep was a continuation of the BowMan Window Manager, which was originally put together by Bo Yang. BowMan was based on the fvwm Window Manager, written by Robert Nation. and fvwm was based on code from twm. and so on.... it's giving ancestry.com for window managers.

the idea was to emulate some of the look and feel of the NEXTSTEP(tm) user interface, but overtime it evolved to include other concepts, as dictated by end user needs. and honestly? it was that unholy direction that made Alfredo Kojima abandon the project in 1997 and create a Window Manger of its own — Window Maker, which had a goal of strict adherance to NEXTSTEP interface ideas. different strokes, we respect it. 🙈

then after releasing version 1.8.11 it became aparent to the developers that the old AfterStep codebase had reached its limits and required a substantial redesign. 😭 and that redesign began with the development of a radically new image handling library, libAfterImage, introducing high quality image manipulation, blending, TrueType fonts, XML image scripting, and more. 🔥

building off of libAfterImage and incorporating new developments in X Window management, AfterStep 2.0 was born and released in September, 2004. and as of now, the AfterStep code base contains none of the original fvwm parts — the association to fvwm, twm and BowMan remain only in history. iconic glow-up, no notes. 👑

🍓 1.4. Fine, what if I'm not running AfterStep 2.0? Is there a FAQ for me? 🍓

yes bestie 💖. there should be a version of the AfterStep FAQ available within your specific AfterStep distribution. if you're using a version earlier than 2.0, it is strongly suggested you upgrade. like. strongly. 👀

🧚 1.5. What is X? What are these window managers? 🧚

"X" is shorthand for The X Window System. it's a basis for building graphical user interfaces for UNIX (it is available for non-UNIX systems too, but it wasn't designed to be as such — so bless). "X" is not the interface itself, it's just a foundation for one. for more info, check www.x.org .

a Window Manager is a program that manages your windows during your X session. AfterStep is one of many, many available window managers . 🌈

💅 1.6. What are AfterStep's main features? 💅

• The Wharf — similar to NeXTSTEP's(tm) Dock, it allows applications to be Swallowed, shortcuts with icons, and many other things.
• The Pager — shows a miniature view of the Afterstep desktops, you can move between them, and move windows around in the Pager as though it were a miniature desktop.
• The WinList — a list of all the windows, and clicking on the items can show that window, destroy it, shade it, or anything you might want.
• Configurability — almost anything can be changed. almost. anything. 🤯
• XML image scripting — AfterStep allows XML scripts to be used to assemble complex images for things like buttons, frame sides, etc, from other, simpler images or graphical primitives.
• TrueType fonts support — Antialised TrueType fonts could be used to render window titles and other labels.
• Unicode, UTF8 and other encodings support — most international character encodings are supported as long as fonts provide glyphs.
• ColorSchemes — AfterStep can calculate a set of about 34 colors to create looks with harmonious color composition. 34! the palette math is real. 🎨

👑 1.7. Is AfterStep 2.0 GNOME and/or KDE compliant? 👑

AfterStep 2.0 supports Extended Window Manager Hints, ICCCM protocol and Motif hints, thus making it as compatible as possible with both GNOME and KDE, as well as most other X applications. she plays nice with everybody. 🫶

🌸 1.8. Can I run it in Microsoft Windows(tm)? 🌸

AfterStep 2.0 does run under Windows using CYGWIN compatibility layer, while running any X server. some of the X servers available under Windows allow so-called root-less mode, where X applications can coincide with native applications. see sample screenshot . 📸

⭐ 1.9. Who develops AfterStep? ⭐

• Sasha Vasko <sasha at aftercode.net> — coordinator, coder, web designer, carpenter, and everything else ( at the moment ).
• Niklas Lunger <niklas at fet dot at> — documentation and user testing.
• Nathan Mahon <as_ml at vaevictus net> — release manager

🎉 1.10. AfterStep is awesome! How can I help? 🎉

Code contributions are welcome. Hardware donations are welcome. if you can help write AfterStep, or feel you can help the effort elsewhere, do so. hang out on irc (#afterstep, efnet), participate on the mailing lists, suggest ideas, help code, etc etc. we love an involved bestie. 💖

🦋 1.11. Who writes this FAQ? 🦋

see 1.9. above. 👆 (it's the same icons, we're not doing the whole list twice.)

---

🌈 2. Resources 🌈

💜 2.1. Where can I find AfterStep resources, or help? 💜

• HTML documentation — AfterStep 2.0 comes installed with complete set of documentation in HTML format, usually installed at /usr/local/share/afterstep/doc/html or /usr/share/afterstep/doc/html . the same documentation is available online from : http://www.afterstep.org/visualdoc.php . if you find that documentation incomplete in some areas — please feel free to submit any corrections to any of the AfterStep mailing lists. 🫶
• WWW Page — the official AfterStep web page is at http://www.afterstep.org/ . this web site is managed by whoever has write access to AfterStep CVS, and is kindly hosted by the generous people at Web Conquest .
• FTP site — the FTP site, ftp://ftp.afterstep.org/ , is the best place to get AfterStep.
• AfterStep applets — the applets (asapps) that go with AfterStep are distributed separately. the applet distribution is maintained by Albert Dorofeev, (<tigr@tigr.net>). you can find the applets at http://www.tigr.net/afterstep/as-apps/ . RPMs for many an applet could be found here : http://www.afterstep.org/rpms/
• Man pages. — the AfterStep installation comes with a set of man pages that attempt to cover all aspects of AfterStep configuration. please read the relevant man page before asking a question. also note that the Pager man page is man Pager (note the capitalization — yes it matters, no we're not kidding).
• IRC — there is also #afterstep on freenode.net IRC servers . feel free to come in and have a chat with us! 💬

🎀 2.2. What are the AfterStep mailing lists, and where are their archives? 🎀

there currently is a mailing list for users to ask questions and get support: as-users.

as-users.

as-users is the general AfterStep mailing list, open to all AfterStep questions, concerns and ideas. subscribe by entering your e-mail at : http://lists.afterstep.org/listinfo.cgi/as-users-afterstep.org

the old mailing list archives can be read at http://www.tigr.net/afterstep/mail/ , while current archives (registration required) can be found at http://lists.afterstep.org/private.cgi/as-users-afterstep.org/ .

🌈 3. Getting and Installing AfterStep 2.0 🌈

Like, you wanna get AfterStep 2.0 on your machine? Say less, bestie. 💅

🎀 3.1. Where can I get AfterStep 2.0? 🎀

You can download AfterStep 2.0 at any of the following locations:

• ftp://ftp.afterstep.org/stable/
• SourceForge.net
• RPM packages

Slay. Go get it. ✨

🛠️ 3.2. What do I need to compile and install AfterStep? 🛠️

Okay so because AfterStep is an X application, you need to have X installed, plus the X development libraries (note, in this case "development" means libraries need to compile things with X, not development-level code). 💀 It's probably a good idea to also have a working C compiler.

AfterStep includes some image libraries, but it is recommended that you install those libraries using your distribution's package management system. Note that you will need development libraries in addition to run-time libraries. The following are the libraries that AfterStep can take advantage of:

• libJPEG - support for JPEG image format
• libPNG - support for PNG image format
• libTIFF - support for TIFF image format
• Freetype - support for TrueType fonts

Note that following image format do not require any external libraries: XPM, PPM, BMP, ICO, XCF, GIF. Periodt. 🦋

💖 3.3. Can I install AfterStep without being root? 💖

Yes! Before compiling AfterStep, do this:

mkdir ~/bin mkdir -p ~/man/man1 ./configure --prefix ~/

Then follow the normal install directions, allowing you to make install without being root. Iconic. 👑

💜 3.4. How do I upgrade AfterStep from AfterStep version prior to 2.0.0?

Install AfterStep 2.0 and then run it. It will start with default configuration that you may or may not like. If you wish to try and reuse your old configuration files, then copy them over from your old ~/GNUstep/Library/AfterStep/ directory and into ~/.afterstep/. Restart AfterStep to make changes effective. If some of the features do not work quite right - feel free to submit bug report along with your configuration files.

It is recommended though that you start with default configuration and try out all of the supplied looks and color schemes. Select whichever is close to what you want and then modify it to your liking. This approach will allow you to take advantage of many new features, available in AfterStep 2.0. 🌸

💜 3.4. How do I upgrade AfterStep from AfterStep version higher then 2.0.0?

Make sure that all configuration files that you ever changed are in your home directory at ~/.afterstep/, as installing afterstep will replace everything in global shared location (/usr/local/share/afterstep). Install afterstep and run. You should not have any trouble. 🫶

💀 3.5. What's up with all these compile errors? 💀

Most likely, you don't have the X devel package (should have come with your operating system, if not, check http://www.x.org/ ). No cap. 🚗

🧚 3.6. How the hell does one configure AfterStep? 🧚

Configuration files are usually either in /usr(/local)/share/afterstep for system wide configuration and ~/.afterstep for personal settings.

Configuration is handled in multiple files: look file (in looks subdirectory) for visual attributes, feel file (in feels subdirectory) for the general behaviour; wharf, winlist, banner, pager, animate for module specific configuration.

Just copy any file you want to modify over from /usr(/local)/share/afterstep to ~/.afterstep to override system wide defaults retaining subdirectory layout. It's giving customization, fr fr. 💜

---

And that's the tea, bestie. This page is from the 3rd Berkeley Distribution, AfterStep v.2.2.12, and it's afterstep_faq(7x). Go forth and configure. ✨💖