Difference between revisions of "Pawm"

From ArchWiki
Jump to: navigation, search
(Initial edit and creation. Hopefully, this will help people out.)
 
m (update link)
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:Stacking WMs (English)]]
+
{{DISPLAYTITLE:pawm}}
 +
[[Category:Stacking WMs]]
 +
[[it:Pawm]]
 
This wiki page details installation and configuration of the PAWM window manager under Arch Linux.
 
This wiki page details installation and configuration of the PAWM window manager under Arch Linux.
 
+
{{Note|It's unmaintained. Latest released version is 2.3.0.}}
__TOC__
+
 
+
 
== Introduction ==
 
== Introduction ==
 
+
[https://sites.google.com/site/pleyadestest/david/projects/pawm PAWM] is an X11 stacking window manager. It is a very small, fast, and simple window manager.  It is based on Xlib and needs no other external libraries to compile it.  It provides an initial windowing environment for minimalist desktops or for single use purposes such as:
PAWM is an X11 stacking window manager. It is a very small, fast, and simple window manager.  It is based on Xlib and needs no other external libraries to compile it.  It provides an initial windowing environment for minimalist desktops or for single use purposes such as:
+
 
*A web browser terminal computer.
 
*A web browser terminal computer.
 
*Testing gui based programs.
 
*Testing gui based programs.
Line 13: Line 12:
 
PAWM was written by David Gómez and Raúl Núñez de Arenas Coronado.  PAWM was written with the objective of creating a tiny window manager that would execute any X application, but still keep it simple and intuitive to use.  
 
PAWM was written by David Gómez and Raúl Núñez de Arenas Coronado.  PAWM was written with the objective of creating a tiny window manager that would execute any X application, but still keep it simple and intuitive to use.  
  
PAWM stands for ''Puto Amo Window Manager''[http://www.pleyades.net/pawm/]. The general translation of ''Puto Amo'' can be found here [http://wiki.answers.com/Q/What_does_el_puto_amo_mean Possibly NSF].  
+
PAWM stands for ''Puto Amo Window Manager'.
  
 
== Installation ==
 
== Installation ==
PAWM is part of the Arch Community repository [http://www.archlinux.org/packages/community/i686/pawm/ i686] [http://www.archlinux.org/packages/community/x86_64/pawm/ x86_64].
+
{{Pkg|pawm}} is part of the Arch [community] repository. To install PAWM, as root type:
To install PAWM, as root type:
+
  # pacman -S pawm
  pacman -S pawm
+
  
 
== Start PAWM with X as default ==
 
== Start PAWM with X as default ==
In order to run PAWM as your default window manager, edit the file <nowiki>~/.xinitrc</nowiki> so the final line is:
+
In order to run PAWM as your default window manager, edit the file {{ic|~/.xinitrc}} (See [[xinitrc]]) so the final line is:
 
  exec pawm
 
  exec pawm
 
If you now type:
 
If you now type:
Line 27: Line 25:
 
at the command prompt, X will start using PAWM for its window manager.
 
at the command prompt, X will start using PAWM for its window manager.
  
If you would like to configure X (and PAWM) to start on boot (or when you login) read the wiki page [[Start X at boot]] to find out how.
+
If you would like to configure X (and PAWM) to start on boot (or when you login) read the wiki page [[Start X at Login]] to find out how.
  
 
== Configuration (making PAWM pretty) ==
 
== Configuration (making PAWM pretty) ==
By default, PAWM looks blue, plain and kind of dated. By editing the file <nowiki>/etc/pawm.conf</nowiki> you can customize the scheme of your PAWM.
+
By default, PAWM looks blue, plain and kind of dated. By editing the file {{ic|/etc/pawm.conf}} you can customize the scheme of your PAWM.
  
 
Colors are changed through hexadecimal values. Fonts can be changed either through core fonts[http://en.wikipedia.org/wiki/X_logical_font_description] or Xft fonts[http://www.x.org/archive/X11R6.8.2/doc/fonts.html].
 
Colors are changed through hexadecimal values. Fonts can be changed either through core fonts[http://en.wikipedia.org/wiki/X_logical_font_description] or Xft fonts[http://www.x.org/archive/X11R6.8.2/doc/fonts.html].
Line 37: Line 35:
  
 
=== Icons ===
 
=== Icons ===
PAWM only supports [http://en.wikipedia.org/wiki/X_PixMap .xpm] format.  Programs like [http://wiki.archlinux.org/index.php/Gimp#GIMP Gimp] can convert images apropriately.   
+
PAWM only supports [http://en.wikipedia.org/wiki/X_PixMap .xpm] format.  Programs like [[GIMP#GIMP|GIMP]] can convert images appropriately.   
  
 
*<span title="Minimize, Maximize, Close" style="border-bottom:1px dotted">Window</span> icons must be 20x20 pixels.
 
*<span title="Minimize, Maximize, Close" style="border-bottom:1px dotted">Window</span> icons must be 20x20 pixels.
Line 43: Line 41:
 
*<span title="Launch/Shortcut" style="border-bottom:1px dotted">Paicon</span> icons may be of any size.
 
*<span title="Launch/Shortcut" style="border-bottom:1px dotted">Paicon</span> icons may be of any size.
  
Any icons used in PAWM '''must''' be put in <nowiki>/usr/share/pawm/icons/</nowiki>
+
Any icons used in PAWM '''must''' be put in {{ic|/usr/share/pawm/icons/}}
  
 
== Application Launcher ==
 
== Application Launcher ==
First, create a directory <nowiki>~/.pawm</nowiki> .  This allows each user to have a unique application set.
+
First, create a directory {{ic|~/.pawm}} .  This allows each user to have a unique application set.
  
 
There are 3 ways to launch programs in PAWM.
 
There are 3 ways to launch programs in PAWM.
*Add it to the <nowiki>~/.xinitrc</nowiki> file.
+
*Add it to the {{ic|~/.xinitrc}} file.
*Execute the program from console with the '''<nowiki>-display</nowiki>''' paramater.
+
*Execute the program from console with the '''{{Ic|-display}}''' paramater.
 
*Use the PAWM application launcher
 
*Use the PAWM application launcher
 
This article covers the third option.
 
This article covers the third option.
Line 85: Line 83:
  
 
== PAWM Utilities ==
 
== PAWM Utilities ==
The following complementary packages can be found in the [http://aur.archlinux.org AUR].
+
The following complementary packages can be found in the [[AUR]].
* Xsri A program that can be used for fast image and gradient setting.  Good for <nowiki>~/.xinitrc</nowiki>
+
* {{AUR|xsri}} A program that can be used for fast image and gradient setting.  Good for {{ic|~/.xinitrc}}
* thinglaunch is a launcher program for X. You can bind it to a key in your favorite window manager. When you want to start a program, just type its name. thinglaunch has a tiny footprint and depends only on Xlib.
+
* {{AUR|thinglaunch}} is a launcher program for X. You can bind it to a key in your favorite window manager. When you want to start a program, just type its name. thinglaunch has a tiny footprint and depends only on Xlib.
* pawmIcons A simple python based utility for creating hassle free Launcher icons.  It does not support custom icons.
+
* {{AUR|pawmIcons}} A simple python based utility for creating hassle free Launcher icons.  It does not support custom icons.

Revision as of 00:43, 31 October 2012

This wiki page details installation and configuration of the PAWM window manager under Arch Linux.

Note: It's unmaintained. Latest released version is 2.3.0.

Introduction

PAWM is an X11 stacking window manager. It is a very small, fast, and simple window manager. It is based on Xlib and needs no other external libraries to compile it. It provides an initial windowing environment for minimalist desktops or for single use purposes such as:

  • A web browser terminal computer.
  • Testing gui based programs.

PAWM creation history

PAWM was written by David Gómez and Raúl Núñez de Arenas Coronado. PAWM was written with the objective of creating a tiny window manager that would execute any X application, but still keep it simple and intuitive to use.

PAWM stands for Puto Amo Window Manager'.

Installation

pawm is part of the Arch [community] repository. To install PAWM, as root type:

# pacman -S pawm

Start PAWM with X as default

In order to run PAWM as your default window manager, edit the file ~/.xinitrc (See xinitrc) so the final line is:

exec pawm

If you now type:

startx

at the command prompt, X will start using PAWM for its window manager.

If you would like to configure X (and PAWM) to start on boot (or when you login) read the wiki page Start X at Login to find out how.

Configuration (making PAWM pretty)

By default, PAWM looks blue, plain and kind of dated. By editing the file /etc/pawm.conf you can customize the scheme of your PAWM.

Colors are changed through hexadecimal values. Fonts can be changed either through core fonts[1] or Xft fonts[2].

You may also adjust adjust the behavior of pabar, paicons, pashut icon or any modules added.

Icons

PAWM only supports .xpm format. Programs like GIMP can convert images appropriately.

  • Window icons must be 20x20 pixels.
  • Pashut icons must be 20x20 pixels.
  • Paicon icons may be of any size.

Any icons used in PAWM must be put in /usr/share/pawm/icons/

Application Launcher

First, create a directory ~/.pawm . This allows each user to have a unique application set.

There are 3 ways to launch programs in PAWM.

  • Add it to the ~/.xinitrc file.
  • Execute the program from console with the -display paramater.
  • Use the PAWM application launcher

This article covers the third option.

Creating new Launcher files

Create a new file in the directory. For our example we will use the terminal emulator Sakura.

The filename must start with app with up to 20 characters after it.

appSakura

Then take your favorite file editor and open the file. The launcher apps have 4 lines that need editing.

  1. The name of the image you want to use.
  2. The initial icon screen position. As you move it, PAWM will edit the X Y coordinates accordingly.
  3. Icon text. This is optional.
  4. Application binary. This can be either relative or absolute path.

The finished file will look like this:

sakura.xpm
40 40
Sakura
sakura

When you next start PAWM your icons will be there. As well, any icon changes including position will be preserved.

Using PAWM

As PAWM is minimalistic, the controls are as well.

  • Double clicking a titlebar scrolls the window up or down respectively.
  • There are Minimize, Restore/Maximize, Close buttons.
  • You can drag windows around.
  • You can drag Launcher icons around.
  • Clicking on open applications on the PABar will minimize and restore.
  • Alt+Tab switches between windows.
  • Clicking on a Launcher executes the program.
  • Clicking on the power button brings up a dialog to quit PAWM.
  • Reloading PAWM refreshes any changes made.

PAWM Utilities

The following complementary packages can be found in the AUR.

  • xsriAUR A program that can be used for fast image and gradient setting. Good for ~/.xinitrc
  • thinglaunchAUR is a launcher program for X. You can bind it to a key in your favorite window manager. When you want to start a program, just type its name. thinglaunch has a tiny footprint and depends only on Xlib.
  • pawmIconsAUR A simple python based utility for creating hassle free Launcher icons. It does not support custom icons.