aewm++(1x)

NAME
aewm++ - a minimalistic window manager for X11

SYNOPSIS
aewm++ -display [display], -fn [font], -fg|-bg|-bd [color], -bw [width], -md [max desktops], -tj [left|center|right], -es [true|false], -wm [true|false], -new1|-new2|-new3 [cmd]

DESCRIPTION
aewm++ is an X11 window manager with a minimal set of features. It provides the most common features found in a window manager. For instance you can iconify, maximize, shade and close windows. You can separate your windows via virtual desktops. Virtual desktops are separate workspaces in which to perform work. Switching them is as easy as pressing the page up or page down keys. By default there are 4 virtual desktops. aewm++ was written from the aewm source code. The reason behind this is simple. aewm is probably the most popular window manager for hackers to fork and hack on. Many window managers were written from its source. However the source code is in C and there are hackers out there I am sure that would like to hack a small window manager written in C++. Hence aewm++ was born. While aewm has minimal features aewm++ will try to build upon it with more features that the author feels necessary in a good minimal window manager.

The titlebar has alot of functionality. Double clicking with the 1st button will maximize a window. Double clicking a maximized window returns it to its original size. Clicking with the first button and dragging will move the window. Using the middle button and clicking the titlebar will shade the window. Do this again on a shaded window and it unshades it. Middle clicking in the box on the right edge of the titlebar will allow you to resize the window. Clicking with the 1st button will iconify the window. Clicking with the 3rd button will delete the window. Virtual Desktops are cycled with the page up and page down keys. If you don't specify the -md [max number of desks] on the command line then you will start with 4 virtual desktops. Currently there is no way to move windows back and forth between desktops. There is also no such thing as sticky windows yet in aewm++. aewm++ is meant to be used with a 3 button mouse. If you don't have one feel free to hack the code to change the functionality of the buttons. As of version 1.0.13 there is now an icon menu. If you middle click on the root window you will see the icon menu if you have clients that are iconified. If no clients are iconified you will see nothing. If you middle click on the root window again while the menu is open it will hide. Icons for the current desktop are the only ones that show. Once you switch desktops whatever icons on that desktop will show. To get the real effect of aewm++ I highly recommend you use it with fspanel. This will give you a nice task bar which will show icons a clock and buttons to switch virtual desktops. The goodies are legacy from aewm. I have no plans at this moment to update them for aewm++.

By default, clicking on the root window with button 1 will run gtk-panel(1x), button 2 will run gtk-switch(1x), and button 3 will start a new xterm(1x). Please note that gtk-panel(1x) reqires a $HOME/.paletterc file to run. Also, gtk-switch(1x) (or an alternative from aewm-goodies(1x)) is needed to unhide hidden windows; aewm++ does not do this itself.

OPTIONS

-display
    Specifies which display to start aewm++ on. This is useful if you want to test aewm++ inside of Xnest.

-md Specifies the number of max virtual desktops to start with. The default number of desktops is 4.

-tj Specifies the text justification for window titles in the titlebar. The options are left, center or right.

-es Specifies if edge snapping is turned on or not. Edge snapping occurs when a window is dragged within 10 pixels of the edge. It is then snapped to the edge. Specify true or false with this option. Default is true.

-wm Specifies if wire move is on or not. If its off then windows are moved via an opaque move. In other words the entire contents of the window are moved when the window is dragged. You specify true or false with this option. Default is true.

-fnfont-spec
    Draw window titles with the font defined by font-spec.

-bwwidth
    Draw window borders width pixels wide. -version Prints version information to the screen and exits.

-new1 cmd, -new2 cmd, -new3 cmd
    Change the command executed when each mouse button is clicked on the root window.

-fg color, -bg color, -bd color
    Use color for the foreground, background, and borders of window frames, respectively.

-version
    Print version information to stdout and exit. aewm++.

SEE ALSO
X(7), The Inter-Client Communication Conventions Manual (from the X11R6 documentation).

AUTHOR
aewm++ by Frank Hale <frankhale@yahoo.com> aewm Decklin Foster <decklin@red-bean.com>