bionic (1) amiwm.1.gz

Provided by: amiwm_0.21pl2-1_amd64 bug

NAME

       amiwm - Amiga Workbench-like X Window Manager

SYNOPSIS

       amiwm

DESCRIPTION

       amiwm is an X Window manager that tries to make your workstation look like an Amiga®

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|filename"}

       Selects either the Workbench® 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.

ScreenFontfontname"

       Selects a font to use for windowtitles etc.

IconFontfontname"

       Selects a font for icontitles.

{detailpen|blockpen|textpen|shinepen|shadowpen|fillpen|filltextpen|

               backgroundpen|highlighttextpen|bardetailpen|barblockpen|
               bartrimpen} “colorname"

       Modifies the colour scheme for the window manager.

CustomIconsOnly {yes|no}

       This  prevent  applications  to  display  their own icons when in iconified state.  Only icons defined in
       amiwmrc for each apps will be used.  Because apps own icon are too different from  one  eachother.   They
       comes  in  various sizes and themes. Some icons will be 32x32, while some other will be a 128x128 or even
       bigger .. By using this option, You have the possibility to decide which icon should  be  used  for  each
       app.   If  no  custom  icons  are  defined at all, the def_tool.info will be used for all iconified apps.
       Format is: style { class "myClass" icon "myIcon.info"  }  To  find  out  a  given  program's  class,  use
       "xlsclients  -l"  to  list  all opened applications, and then use "xprop -id <0x0000000>" to list a given
       app's properties. Use either WM_CLASS or WM_ICON_NAME strings in amiwmrc.

ShortLabelIcons {yes|no}

       This limit the length of the text for iconified programs. For example, if this option  is  activated,  an
       iconified  program  text  will  be limited to 8 chars + ".."  Use this option if you don't want iconified
       program text to be loong strings..

TitleBarClock {yes|no}

       Enables a clock in the titlebar.  It displays the date and time.

TitleClockFormat [<number>] time string

       This lets you choose a new format to display the Title Bar Clock.  The time string is formatted with  the
       standard  strftime()  parameters.   The default is "%c".  It has been found that "%a %b %e %Y   %l:%M %p"
       works well too.  Number is the update interval in seconds.

ToolItemname"command"hotkey"

       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.

ToolItemname" { <tool item commands>}

       Create ToolItem:s in a submenu with the specified name.  It is not  legal  to  create  a  submenu  inside
       another submenu.

Screen [<number>]name"

       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.

ModulePathpath(:path...)"

       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.

Modulename" ["initstring"]

       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

       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@mc.pp.se

                                                   19 Jul 2010                                          amiwm(1)