amiwm(1)
NAME
amiwm - Amiga Workbench-like X Window Manager
SYNOPSIS
aammiiwwmm
DESCRIPTION
amiwm is an X Window manager that tries to make your workstation look
like an Amiga(R)
OPTIONS
Amiwm is configurable with a $HOME/.amiwmrc-file containing some or all
of the following options:
FastQuit: {yes|no}
Specifies whether amiwm should quit directly when the Quit menu item is
selected, rather than popping up a requester. (on/off or true/false
can be used instead of yes/no.)
SizeBorder {right|bottom|both|none}
Specifies which border should be enlarged when a sizegadget is present.
ForceMove {manual|auto|always}
Enables you to move windows outside the perimeter of the root window
when pressing shift, when trying to drag at least 25% of the window
ofscreen, or always, respectively.
IconDir path
Specifies a directory in which amiwm will look for icons.
DefaultIcon name
Gives the filename of the .info file to use as a default icon. It is
relative to the IconDir.
IconPalette {system|magicwb|schwartz|
Selects either the Workbench(R) default palette, or the MagicWorkbench
standard palette for use with icons. The third option is a 16 color
palette used on the "Eric Schwartz Productions CD Archive". Alternatively, the filename of a PPM file representing the palette to use can
be used.
ScreenFont
Selects a font to use for windowtitles etc.
IconFont
- Arraybackgroundpen|highlighttextpen|bardetailpen|barblockpen|
bartrimpen} "colorname" - Modifies the colour scheme for the window manager.
ToolItem
Adds an item in the Tools menu with the specified name, which executes
the command when selected. A string containing a single uppercase letter may be specified as the third argument, making this letter a hotkey
for the item.
ToolItem Separator
Inserts a separator bar in the Tools menu.
ToolItem
Create ToolItem:s in a submenu with the specified name. It is not
legal to create a submenu inside another submenu.
Screen []
Create a new screen with the specified name. It will be placed below all earlier created screens. To move a window between two screens, iconify it and drag the icon over to the other screen. If the second argument is given, this screen is placed on the corresponding X screen.
ModulePath
Sets one or more directories where amiwm will look for module binaries.
The default is AMIWM_HOME. Note that the module binaries cannot be
shared amongst different architectures.
Module
Start a module with the specified name. If initstring is specified, it
is sent to the module. There are currently two modules shipped with
amiwm; Background and Keyboard. These are documented in the file
README.modules. If a module is limited to a single screen, like the
Background module, the screen that was created last is used.
InterScreenGap number
Sets the size in number of pixels of the "video DMA off" area that
appears between screens when they are dragged.
AutoRaise {yes|no}
Selects whether windows will automatically be moved to the front when
they are activated.
Focus {followmouse|sloppy|clicktotype}
Sets the policy by which windows are given focus. Followmouse is the
default and means that the window that contains the mouse pointer will
have focus. Sloppy means that the window that had focus last will keep
it when the pointer is not over a window. ClickToType is the original
AmigaOS policy in which you have to explicitly give focus to windows by
clicking in them.
TROUBLESHOOTING
The most likely reason for amiwm to crash is if it can't find its
default icon, or if this is not accepted as a *.info file. If this
happens, amiwm _will_ dump core. So make sure that either 'make
install' runs successfully (in which case amiwm will know where its
icon is), or that the file .amiwmrc contains a correct specification of
the icon's location.
FILES
$HOME/.amiwmrc
$AMIWM_HOME/system.amiwmrc
COPYRIGHT NOTICES
This program is distributed as freeware. The copyright remains with the
author. See the file LICENSE for more information. Amiga and Workbench are registered trademarks of AMIGA International Inc.
AUTHOR
- Marcus Comstedt, marcus@lysator.liu.se