ratpoison est un gestionnaire de fenêtres simple sans grosse dépendances. pas de gadgets graphiques, pas de décoration de fenêtre, et aucune dépendance à l'égard du mulot :) . Il est largement calquée sur GNU Screen qui a fait des merveilles sur le marché du terminal virtuel. Toutes les interactions avec le gestionnaire de fenêtres se font avec le clavier. ratpoison fonctionne avec un combo-clavier (Control-t) comme touche de modification, qui permet de ne pas paralyser Emacs ou d'autres logiciels de qualité. ratpoison a été écrit par Shawn Betts sabetts@gmail.com.

au moment ou j'écris ces lignes, la dernière version de ratpoison est la 1.4.6.
le processus d'installation est classique: on installe les dépendances:

# apt-get install automake makeinfo texinfo libx11-dev libxext-dev x11proto-core-dev libreadline5-dev x11proto-xext-dev libxtst-dev

on récupère l'archive, on décompressse, on configure, make, install. plus de détails dans les fichiers inclus (README, INSTALL…):

$ wget http://download.savannah.gnu.org/releases/ratpoison/ratpoison-1.4.6.tar.xz
$ tar -xJf ratpoison-1.4.6.tar.xz
$ cd ratpoison-1.4.6.tar.xz
$ ./configure
$ make
# make install

ratpoison est présent dans les dépôts Debian, cependant, la version de Debian Wheezy est la 1.4.5 (parfaitement fonctionnelle). pour l'installer:

# apt-get install ratpoison

ratpoison utilise le concept de cadres ou frames pour placer ou redimensionner les fenêtres: Au lieu de laisser les fenêtres se placer arbitrairement sur l'écran, celui-ci est divisé en cadres. les fenêtres se placent maximisées dans ces cadres. ratpoison se lance avec un cadre qui peut être divisé en plusieurs cadres plus petits. Chaque cadre peut être divisée en deux, horizontalement ou verticalement. Vous pouvez vous déplacer parmi eux, ou en créer de nouveaux. Pour plus d'informations, consultez la section frames.

Chaque cadre a une fenêtre ou plus qui lui est associée, qui est visible dans ce cadre. Si vous sélectionnez une fenêtre qui est associé à un cadre, le focus se déplace vers le cadre associé, plutôt que de déplacer la fenêtre dans le cadre actuel actuelle. Si vous sélectionnez une fenêtre qui n'est pas associée à un cadre, cette fenêtre sera ouverte dans le cadre actuel et redimensionnée pour s'adapter à ce cadre.

Si la fenêtre associée ne remplit pas complètement le cadre, les différentes commandes de gravité contrôlent la façon dont elle est placé.

Si aucune fenêtre n'était ouverte dans ce cadre avant la création du cadre, le bureau sera visible derrière elle.

Quand ratpoison démarre, vous devriez voir un serveur X vide. Pour ouvrir un terminal, taper “C-t c”. Vous pouvez maintenant exécuter des commandes shell comme vous le feriez sur n'importe quel terminal. Remarquez le terminal maximisé plein écran. “C-t!” vous ouvrira une invite de commande simple vous permet d'économiser l'effort d'ouvrir un terminal.

Une fois que vous avez quelques programmes en cours sur X, vous aurez envie de naviguer entre les fenêtres. Pour voir quelles fenêtres sont gérées, tapez “C-t w”. Chaque fenêtre a un numéro. Vous pouvez passer d'une fenêtre en appuyant sur “C-t” suivi par le numéro de la fenêtre. Cela suppose que le numéro de la fenêtre est un chiffre. Vous pouvez également passer à une fenêtre en tapant une partie de son nom. Pour ce faire, taper “C-t '”.

ratpoison vous permet de faire défiler les fenêtres avec “C-t n” et “C-t p”.

ceci est une brève introduction sur la façon d'utiliser ratpoison. Remarquez comment nous n'avons pas eu à faire glisser une fenêtre unique, ou cliquez sur un seul bouton d'agrandissement… “It's modern computing at its best”.

liste des commandes acceptées pour la manipulation des fenêtres:
pour lancer une commande dans ratpoison: “C-t :” (“Control+t” puis “:”)

vous pouvez ajouter un nombre devant le format afin de définir le nombre de caractères à afficher, ex: “%n%s%20t”.

“Window classes” est une façon de regrouper les fenêtres. les fenêtres d'un même programme ont généralement la même propriété “classe” définie par 'xprop'. ratpoison utilise cette propriété pour naviguer entre le fenêtres selon leur classe. bine pratique pour ne circuler que parmis les “XTerms” par exemple.

ratpoison peut ne pas gérer certaines fenêtres. ratpoison garde une liste de termes et toute nouvelle fenêtre correspondant à l'un de ces termes ne sera pas gérée par ratpoison.
The following are commands to manipulate this list:

Some programs will attempt to steal the focus without the users permission. Not only is this a sign of a lame programmers attempt to fix a window manager problem in the wrong place, it's just plain rude. By default ratpoison will honour these rudeness requests, but it doesn't have to. Use the rudeness command to deal with such programs.

There are two kinds of windows: normal windows (like an xterm) and transient windows (generally pop-up dialog boxes). When a client program wants to display a new window it makes a requests to ratpoison. ratpoison then decides whether to grant the request and display the window or ignore it. A client program can also request that one of its windows be raised. You can customize ratpoison to either honour these requests (the default operation) or ignore them.

• Bit 0 : Tells ratpoison to grant raise requests on transient windows
• Bit 1 : Tells ratpoison to grant raise requests on normal windows
• Bit 2 : Tells ratpoison to grant display requests on new transient windows
• Bit 3 : Tells ratpoison to grant display requests on new normal windows

For example, if you wanted only wanted to grant transient windows raise requests and display requests you would type `rudeness 5'. If a request is not granted ratpoison will tell you about the request with a message like `Raise request from window 1 (emacs)'.

ratpoison peut grouper les fenêtres entre elles. cette option couplée à la configuration avancée des frames permet d'obtenir un équivalent aux “bureaux” ou “espaces de travail”.

même si ratpoison ne gère pas les bureaux virtuels, il vous offre la possibilité d'écrire des scripts à cet effet. de tel scripts existent dans le dossier “contrib/” des sources: les “rpws”. consultez ce dossier pour plus de détails sur le support des bureaux virtuels dans ratpoison.

les groupes sont plus flexibles que les bureaux virtuels. une fenêtre d'un groupe peut être visible dans d'autres groupes. si vous changez de groupe, rien ne change sauf la liste des fenêtres dans laquelle vous circulez. ratpoison vous permet de créer des groupes, de déplacer des fenêtres d'un groupe à l'autre, de fusionner des groupes (merge) ou de les détruire.

voici la liste des commandes appliquables aux groupes.

les frames sont les cadres dans lesquels s'affichent les fenêtres.

ou comment diviser les cadres dans ratpoison pour afficher plusieurs fenêtres à l'écran.

• pour diviser une frame horizontalement “C-t s”
• pour diviser verticalement “C-t S”
  si vous avez plusieurs fenêtres ouvertes, vous constaterez que ratpoison occuppe le nouveau cadre avec un autre fenêtre automatiquement. vous pouvez utilisez les touches de navigations pour circulez dans le cadre.
  notez que si vous sélectionnez une fenêtre avec son nom ou son numéro, le cadre de la fenêtre sélectionnée deviendra le cadre actuel.

• pour circuler entre les frames, “C-t tab”.
• pour effacer une frame, “C-t R”. ratpoison ajuste automatiquement la taille des autres frames pour occuper l'espace disponible. cependant, il est possible que ratpoison remplisse l'espace d'un manière inattendue.
• pour revenir à l'affichge en plein écran (eliminer les divisions), “C-t Q”.

les commandes appliquables aux frames

*n peut être une fraction au format x/y ou un nombre de pixels.

• si “n” est une fraction, le cadre actuel sera divisé selon cette fraction, créant le nouveau cadre dans l'espace libéré. ex: “split 1/4” réduira le cadre actuel au 1/4 de sa taille originale et laissera les 3/4 restant pour le nouveau cadre.
• si “n” est un nombre de pixels, le cadre original sera agrandit de “n” pixels
• si “n” est un nombre négatif de pixels, le cadre original sera réduit de “n” pixels

ou comment redimensionner une frame avec la commande resize. le raccourcis par défaut: “C-t r”.
la commande “resize” dépend de 2 arguments, qui définissent respectivement le redimensionnement horizontal et vertical du cadre. ex: pour agrandir le cadre actuel de 50px horizontalement et le réduire verticalement de 10 px, on utilisera la commande “resize 50 -10”

pour un redimensionnement depuis les raccoucis clavier (confirmation de la taille avec [Enter]):

l'echelle de redimensionnement est définie par la commande “set resizeunit”.

voici les commandes acceptées pour circuler entre les frames.

ratpoison propose deux commandes, fdump et frestore, qui vous permettent de sauvegarder un agencement des frames.
utilisation: vous avez divisé votre écran en plusieurs frames mais vous souhaitez temporairement revenir à un affichage fullscreen sans pour autant perdre votre agencement à l'écran. utilisez alors “fdump” pour sauvegarder vos frames, puis tapez “C-t Q” pour effacer vos divisions et sélectionnez le cadre sur lequel vous désirez travailler en plein écran. une fois fini, utilisez “frestore” pour rétablir votre agencement initial.

si une fenêtre occupe un cadre avant le “dump” et est fermée avant le “restore”, l'espace de cette fenêtre restera vide.

lancer “fdump”, copier-coller le “dump” à chaque fois est un peu contre-productif. visitez votre dossier sources doc/sample.ratpoisonrc pour une série de raccourcis accomplissant ce processus.

les frames sont indentifiées par des numéros commencant par 0, mais la commande “framesels” permet de renommer les frames avec des chiffres ou des lettres.

set framesels abcdefghijklmnopqrstuvwxyz

le code ci-dessus renomme les frames avec des lettres et les agence dans l'ordre alphabétique.

une frame dédiée “dedicated” est un cadre dans lequel aucune fenêtre ne s'affiche automatiquement: seul l'utilisateur peut lui assigner une fenêtre.

le système X window assigne un numéro à chaque écran connectés reconnus. pour naviguer entre ces écrans, utiliser les commandes “nextscreen” et “prevscreen”, ou “sselect” pour aller directement à un écran spécifique. ratpoison indiquera quel frame détient le focus avec une fenêtre de dialogue.

la plupart des commandes de ratpoison ne s'appliquent qu'à l'écran actuel. si vous désirez circuler entre deux fenêtres sur deux écran avec la commande “other”, vous verrez un message “No other window.” car il n' y a pas d'autres fenêtres sur l'écran actuel. si vous désirez aller à l'écran suivant, vous pouvez sélectionner la fenêtre depuis son nom (avec “select” ou “C-t '”), son numéro, ou utiliser “nextscreen”, “prevscreen”, et “sselect”.

ratpoison se contrôle intégralement depuis le clavier: commandes ou raccourcis.

ratpoison utilise l'organisation des raccourcis Emacs: une combinaison de touches de modifications suivies de touches classiques pour exécuter une action. la syntaxe: une ou plusieurs touches de modifications séparées par “-” puis une touche classique.

liste des touches de modifications acceptées par ratpoison:

• S : Shift
• C : Control
• M : Meta
• A : Alt
• H : Hyper
• s : Super

ratpoison utilise la propriété keysym de X11. les touches alphanumériques sont celles que vous voyez sur votre clavier. les ponctuations ont des noms différents selon le serverX utilisé. pour trouver le nom d'une touche, voir la commande “describekey”. pour savoir si une touche est assignée à une action, taper “C-t” puis la touche concernée: ratpoison affichera un message avec le nom de la touche (si elle n'est pas assignée).

tous les raccourcis sont contenus dans une table ou “keymap”. lorsque vous tapez le préfixe “C-t”, vous appelez le keymap 'root'. par défaut, toutes les commandes sont accessibles depuis le keymap principal commancant par “C-t”.

il existe aussi une table supérieure, “top keymap”. tous les raccourcis de cette table sont accessibles simplement en pressant une touche. c'est là que le préfixe entre en jeu.

l'exemple suivant assigne “C-x b” à l'échange des fenêtres, comme le “C-x b” dans Emacs.

# création du keymap
newkmap ctrl-x
# assigne b à 'select' dans le nouveau keymap
definekey ctrl-x b select
# attache notre keymap au "top key map" via C-x.
definekey top C-x readkey ctrl-x

voici les commandes pour créer, éditer ou supprimer une table de raccourcis.

les raccourcis par défaut sont rassemblés dans ce tableau. notez que toutes les commandes ne sont pas associées à des raccourcis.

un des buts de ratpoison est de permettre à l'utilisateur de créer des modifications en accord avec ses besoins ou sa façon de travailler. les “Hooks” permettent à l'utilisateur d'associer une série de commandes à un évènement.

chaque “hook” contient une série de commandes à exécuter lorsque qu'un évènement arrive dans ratpoison. par ex, si vous souhaitez renvoyer le pointeur à chaque exécution d'un raccourcis clavier, ajoutez cette ligne dans votre fichier .ratpoisonrc: “addhook key banish” (sans les “”). ça devrait suffir pour tenir le mulot hors de portée.

• Command: addhook hook command : ajoute “command” à “hook”. lorsque “hook” arrive, “command” est exécuté.
  voici la liste des “hooks” acceptés par ratpoison:

• Command: “remhook hook command” : efface “command” de “hook”. voir “addhook” pour la liste des “hooks” acceptés.
• Command: “listhook hook” : liste des commandes exécutées lorsque “hook” arrive.

ratpoison affiche les notifications, commandes, listes des fenêtres etc, dans une barre de messages située par défaut dans le coin supérieur droit de l'écran. cete barre s'efface en 5 secondes par défaut.

voici les commandes modifiant le comportement et l'aspect de la barre de messages:

il peut arriver qu'un programme ne puisse pas s'afficher correctment dans ratpoison. ratpoison fournit deux commandes pour pallier à ce problème: tmpwm et newwm.

ces commandes doivent être utilisée aussi rarement que possible. elles sont simplement là pour montrer à l'utilisateur que certains programmes sont si explicitement préconfigurés, qu'il est impossible de changer leur façon de gérer leurs interfaces.

• Command: tmpwm WM : donne le contrôle temporaire à un autre gestionnaire de fenêtres, puis revient à ratpoison lors de la fermeture du wm. “WM” est le nom de l'exécutable ou l'adresse du wm.
• Command: newwm window-manager : mauvaise commande. ça tue ratpoison et fait revenir ce vilain mulot! ne pas faire!

une petite liste de commandes acceptées par ratpoison et pas forcément détaillées précédement.

Command	Keys & Action
abort	pratique. par défaut key=“C-t g”: abandonne la dernière combinaison de touches (comme C-g dans 'Emacs').
alias name command	permet de nommer une commande de ratpoison autrement. ex: création d'un alias pour firefox: “alias ffx exec firefox” un alias est traité comme une commande lancée depuis “C-t :”, vous pouvez l'associer à une touche, et la lancer depuis “ratpoison -c”.
banish	envoi le pointeur dans le coin inférieur droit de l'écran.
banishrel	envoi.le pointeur dans le coin inférieur droit de la fenêtre. si il n'y a pas de fenêtres, dans le coin de la frame.
chdir	change le répertoire courant de ratpoison.
colon command	lance une commande ratpoison.
compat	Install the now obsolete `def*' commands as aliases to the corresponding `set *' command.
set padding left top right bottom	définir les marges aux bords d'écran. sans arguments, affiche les valeurs actuelles.
set waitcursor n	définir si le pointeur est “carré” en attendant une touche (0) ou pas(différent de 0). sans argument, affiche la valeur actuelle.
set historysize n	définir la taille de l'historique des commandes ratpoison. sans argument, affiche la valeur actuelle.
set historcompaction bool	définir si on efface les commandes identiques dans l'historique. sans argument, affiche la valeur actuelle.
set historexpansion bool	Set whether to expand ! using readline's libhistory in input.
escape key	définir le préfixe ,la combinaison de touche qui accède au keymap 'root' (“C-t” par défaut). ex: 'escape C-b' défini le préfixe à <C-b>.
exchangedown	échange la frame active avec celle du dessous.
exchangeleft	échange la frame active avec celle de gauche.
exchangeright	échange la frame active avec celle de droite.
exchangeup	échange la frame active avec celle du dessus.
exec command	exécute une commande shell. par défaut key=“C-t !”.
execa command	exécute une commande shell sans enregistrer depuis quelle frame.
execf frame command	Execute a shell command and choose which frame the client's first window will open in. The client must be netwm compliant for this to work.
getenv env	affiche la variable d'environnement, “env”.
getsel	affiche la dernière sélection X11.
help	affiche la liste des raccourcis claviers.
license	affiche la licence ratpoison. par défaut key=“C-t V”.
meta key	“key” est optionnel. si omit, la commande simule un “Control-t” sur la fenêtre active. si “key” est défini, “key” est envoyé à la fenêtre active.
prompt prompt	affiche une invite de commande dans la fenêtre de messages.
putsel text	définir “text” comme sélection X11.
quit	quitter ratpoison.
ratinfo	affiche les coordonnées relatives du pointeur sur l'écran.
ratrelinfo	affiche les coordonées relatives du pointeur sur la fenêtre ou la frame active.
ratrelwarp x y	déplace le pointeur selon x et y depuis sa position initiale.
ratwarp x y	déplace le pointeur selon x et y sur l'écran.
ratclick button	simule un clic. “button” peut être 1, 2, ou 3. par défaut: “1”.
rathold state button	clic ou relache le “bouton” selon son état initial.
redisplay	redessine la fenêtre active.
restart	redémarre ratpoison (relecture du ratpoisonrc).
set var value	définir la valeur d'une variable ratpoison voici la liste des variables modifiables: framesels, winliststyle, barpadding, bgcolor, fgcolor, winname, winfmt, waitcursor, inputwidth, barborder, border, padding, font, bargravity, maxsizegravity, transgravity, wingravity, maxundos, resizeunit, historysize, historycompaction, historyexpansion.
setenv env value	définir la variable d'environnement “env” à “value”.
source file	lire un fichier contenant des commandes ratpoison.
startup_message state	masque le message d'acceuil: à mettre dans votre ~/.ratpoisonrc.
swap destination-frame source-frame	échange une fenêtre d'une frame avec une autre.
time	affiche l'heure dans la barre de messages.
unalias name	efface “name” e la liste des alias.
unsetenv env	rétablir la variable d'environnement “env” à sa valeur par défaut.
verbexec command	exécute la commande shell “command” en mode verbeux.
version	affiche la version de ratpoison. par défaut key=“C-t v”.
warp state	par défaut, ratpoison sauvegarde la position du pointeur sur une fenêtre et la rétablit au retour sur cette fenêtre. cette commande permet de désactiver cette option “state” peut être “on” ou “off”.

ratpoison vous invite souvent dans la zone de saisie ou input: pour lancer une commande, choisir une fenêtre, d'finir une valeur…
voici les raccourcis autorisés dans la zone de saisie:

toutes les entrées saisies sont stockées dans le fichier ~/.ratpoison_history contenant 100 lignes par défaut. ce fichier est lu au démarrage de ratpoison comme l'historique bash de votre terminal.

ratpoison accepte une série d'argument qui peuvent être passées directement en ligne de commande.

arrivé en fin de page, vous vous demandez certainement où se trouve le fichier de configuration de ratpoison. par défaut, ratpoison lit le fichier /etc/ratpoisonrc, mais vous pouvez créer le votre dans ~/.ratpoisonrc. en fait, ratpoison n'en a pas vraiment besoin mais ce fichier permet de définir quelques variables, des alias et de définir certains programmes à lancer au démarrage de ratpoison.
notez que ce fichier est relu à chaque redémarrage de ratpoison “C-t :restart”.

vous pouvez utiliser l'option “ratpoison -f” pour définir un fichier de configuration différent.
vous trouverez une multitude d'exemple de 'ratpoisonrc' sur le net, je vous livre le mien, plutôt minimaliste:

# ratpoison config and startup file
# set options and startup applications and commands
###################################################

## set some variables -----------------------------
# font to use on status message
set font "Droid Sans Mono-11"
# status text color
set fgcolor DeepSkyBlue4
# status background color
set bgcolor gray20
# border focus color
set fwcolor DeepSkyBlue4
# border unfocused color
set bwcolor gray20

## bind some keys ---------------------------------
# dmenu with C-t d
bind d exec dmenu-bind.sh
# livarp ratmenu with C-t m
unbind m
bind m exec .ratpoison/rat_main_menu

## open a terminal on startup/restart -------------
exec (sleep 4s && urxvtcd)

ratpoison est un gestionnaire de fenêtres atypique. il peut se classer dans la catégorie des “tilings wms” car il occupe toute la place sur l'écran, mais son système de gestion des frames (contrairement aux “tags” de dwm, awesome ou spectrwm) reste unique.
je vous conseille de rester 2 ou 3 jours sur ratpoison pour réellement apprécier ses fonctionnalités, le temps de vous habituer aux raccourcis clavier :)

sources : wiki ratpoison