Pour commencer avec une opération basique, ouvrons un terminal. Par défaut, vous devez utiliser le raccourcis clavier $mod+Enter pour y parvenir, c'est à dire Alt+Enter (Mod1+Enter). En pressant $mod+Enter, une nouvelle fenêtre de terminal s'ouvre. Elle remplira la totalité de votre écran.

Si vous ouvrez maintenant un autre terminal, i3 le placera à côté du terminal actuel, divisant la taille de l'écran en deux. En fonction de votre moniteur, i3 placera la fenêtre créée à côté de la fenêtre existante (sur les écrans larges) ou sous la fenêtre existante (écrans pivotés).

Pour déplacer le focus entre les deux terminaux, vous pouvez utiliser les touches de direction que vous connaissez peut-être dans l'éditeur vi. Cependant, dans i3, c'est votre ligne de départ qui est utilisé pour ces touches (dans vi, les touches sont décalées vers la gauche de un pour la compatibilité avec la plupart des dispositions de clavier).
Par conséquent, sur un clavier azerty-fr $mod+j déplace le focus à gauche, $mod+k en bas, $mod+l en haut et $mod+m à droite. Donc, pour basculer entre les terminaux, utilisez $mod+k ou $mod+l. Bien sûr, vous pouvez également utiliser $mod + les touches fléchées.

Pour le moment, votre espace de travail est divisé (il contient deux terminaux) dans une direction spécifique (horizontale par défaut). Chaque fenêtre peut à nouveau être divisée horizontalement ou verticalement, tout comme l'espace de travail. La terminologie est "fenêtre" pour un container qui contient en fait une fenêtre X11 (comme un terminal ou un navigateur) et "split container" (container fractionné) pour les "contenairs" qui se composent d'une ou plusieurs fenêtres..

TODO: picture of the tree

Pour diviser une fenêtre verticallement, pressez $mod+v avant de créer une nouvelle fenêtre. Pour la diviser horizontallement, pressez $mod+h.

Un container divisé peut adopter plusieurs dispositions :

Pour passer d'un mode à l'autre : pressez $mod+e pour les modes 'splith/splitv', $mod+s pour le mode 'stacking' et $mod+w pour le mode 'tabbed'.

Pour afficher une fenêtre en plein écran (fullscreen) ou pour revenir à l'affichage normal, pressez $mod+f.

Il existe aussi un mode "fullscreen global" dans lequel i3 affiche le client sur tous les moniteurs disponibles. (la commande est fullscreen toggle global).

Vous pouvez utiliser votre terminal pour lancer vos applications, mais vous pouvez aussi utiliser le menu dmenu qui s'ouvre par défaut grâce au raccourcis $mod+d. [Notez que sur nakeDeb, dmenu est remplacé par rofi]. Entrez le nom d'une application ou seulement quelques lettres. Les applications correspondantes seront listées si elles sont dans votre $PATH.

Si vous utilisez certaines applications de manière fréquente, vous pouvez leur attribuer des raccourcis clavier. Voir la section [configuration] pour plus de détails.

Si une application ne dispose pas de raccourcis clavier dédié à sa fermeture (la plupart des applications peuvent se fermer depuis leur menu ou depuis les raccourcis Control+w ou Control+q), vous pouvez presser $mod+Shift+q pour tuer une fenêtre. Pour une application qui supporte le protocole WM_DELETE, cela fermera correctement l'application (sauvegarde des modifications et nettoyage du cache). Si l'application ne supporte pas le protocole WM_DELETE, le serveur X tuera l'application. Le comportement dépend de l'application.

Les espaces de travail sont un moyen simple de regrouper un ensemble de fenêtres. Par défaut, vous êtes sur le premier espace de travail, comme l'indique la barre en bas à gauche. Pour passer à un autre espace de travail, appuyez sur $mod+num avec num correspondant au numéro de l'espace de travail à atteindre. Si l'espace de travail n'existe pas, il sera créé.

Une organisationn classique est de lancer le navigateur sur le premier espace de travail, puis les applications de communication (mutt, irssi, …) sur un deuxième et enfin, travailler sur le troisième espace de travail. Mais vous n'êtes pas obligé d'utiliser cette approche.

Si vous disposez de plusieurs écrans, un espace de travail sera créé sur chaque écran au démarrage. Si vous ouvrez un nouvel espace de travail, il sera lié à l'écran sur lequel vous l'avez créé. Lorsque vous passez à un espace de travail sur un autre écran, i3 donne le focus sur cet écran.

Pour déplacer une fenêtre sur un espace de travail donné, pressez simplement $mod+Shift+num avec num correspondant au numéro de l'espace de travail visé. Comme pour le changement d'espace de travail, s'il n'existe pas, il sera créé.

Le moyen le plus simple de redimensionner un container est d'utiliser la souris : saisissez la bordure et déplacez-la à la taille souhaitée.

Vous pouvez également utiliser le clavier et les [binding_modes] pour redimensionner un container. Pour un exemple, consultez la configuration par défaut fournit par i3.

Pour relancer i3 (afin de repartir sur de bonnes bases après avoir résolu un bug ou pour prendre en compte une mise à jour de i3) vous pouvez utiliser le raccourcis $mod+Shift+r.

Pour quitter proprement i3 sans tuer votre serveur X, pressez simplement $mod+Shift+e. Par défaut, un message sera affiché afin de confirmer que vous désirez réellement quitter i3.

Le mode flottant est l'opposé du mode mosaïque (tiling). La position et la taille d'une fenêtre ne sont pas gérées automatiquement par i3, mais manuellement par vous. L'utilisation de ce mode peut être utile pour certains cas particuliers comme les fenêtres de dialogue "Enregistrer sous" ou les fenêtres de barre d'outils (GIMP ou similaire). Ces fenêtres s'identifient généralement de façon appropriée et sont ouvertes en mode flottant par défaut.

Vous pouvez désactiver le mode flottant en pressant $mod+Shift+Space. En faisant glisser la barre de titre de la fenêtre avec votre souris, vous pouvez déplacer la fenêtre. En saisissant les bordures et en les déplaçant, vous pouvez redimensionner la fenêtre. Vous pouvez aussi faire tout ça grâce au [floating_modifier]. Une autre façon de redimensionner les fenêtres flottantes à l'aide de la souris consiste à cliquer avec le bouton droit sur la barre de titre et à faire glisser.

Pour redimensionner les fenêtres flottantes avec votre clavier, voir les raccourcis de redimensionnement prévus dans la configuration par défaut de i3.

Les fenêtres flottantes sont toujours affichées par dessus les autres.

Les éléments constitutifs de notre arbre sont les Containers. Un Container peut héberger une fenêtre (c'est-à-dire une fenêtre X11, que vous pouvez réellement voir et utiliser, comme un navigateur). Sinon, il peut contenir un ou plusieurs containers. Un exemple simple est l'espace de travail : lorsque vous démarrez i3 avec un seul moniteur, un seul espace de travail et que vous ouvrez deux fenêtres de terminal, vous vous retrouverez avec une arborescence comme celle-ci :

Il est logique d'utiliser des containers divisés (Split Containers) afin de créer une organisation lorsque vous utilisez un arbre comme structure de données. Dans i3, chaque container a une orientation (horizontale, verticale ou non spécifiée) et l'orientation dépend de la disposition dans laquelle se trouve le container (vertical pour splitv et stacking, horizontal pour splith et tabbed). Ainsi, dans notre exemple avec l'espace de travail, la disposition par défaut de l'espace de travail Container est splith (la plupart des moniteurs sont à écran large de nos jours). Si vous changez la disposition en splitv ($mod+v dans la configuration par défaut) puis ouvrez deux terminaux, i3 configurera vos fenêtres comme ceci :

Une nouvelle fonctionnalité intéressante d'i3 depuis la version 4 est la possibilité de tout diviser : supposons que vous ayez deux terminaux sur un espace de travail (avec une disposition splith, c'est-à-dire une orientation horizontale), le focus est sur le terminal de droite. Vous souhaitez maintenant ouvrir une autre fenêtre de terminal sous la fenêtre actuelle. Si vous ouvrez simplement une nouvelle fenêtre de terminal, elle apparaîtra à droite en raison de la disposition splith. Au lieu de cela, appuyez sur $mod+v pour diviser le container avec la disposition splitv (pour ouvrir un container de fractionnement horizontal, utilisez $mod+h). Vous pouvez maintenant ouvrir un nouveau terminal et il s'ouvrira en dessous de l'actuel :

Vous l'avez probablement déjà deviné : il n'y a pas de limite à la profondeur de votre hiérarchie de divisions.

Restons avec notre exemple ci-dessus. Nous avons un terminal à gauche et deux terminaux divisés verticalement à droite, le focus est sur celui en bas à droite. Lorsque vous ouvrez un nouveau terminal, il s'ouvrira sous le terminal actuel.

Comment ouvrir un terminal à droite du terminal courant ? La solution est d'utiliser le focus au container parent, qui passera le focus au Parent Container du Container courant. Dans la configuration par défaut, utilisez le raccourcis $mod+a pour remonter le focus dans l'arborescence du Container (vous pouvez répéter l'opération jusqu'à atteindre le Workspace Container). Dans ce cas, le focus sera donné au Vertical Split Container (container divisé verticalement) qui est lui-même à l'intérieur de l'espace de travail orienté horizontalement. Désormais, une nouvelle fenêtre s'ouvrira à droite du container divisé verticalement (Vertical Split Container) :

Dans certains cas, i3 doit créer implicitement un container pour exécuter votre commande.

Un exemple avec le scénario suivant : Vous démarrez i3 avec un seul moniteur et un seul espace de travail sur lequel vous ouvrez trois fenêtres de terminal. Toutes ces fenêtres de terminal sont directement attachées à un nœud dans l’arborescence de disposition d’i3, le nœud de l’espace de travail. Par défaut, l’orientation du nœud de l’espace de travail est horizontale.

Maintenant, vous déplacez l'un de ces terminaux vers le bas ($mod+Shift+k par défaut). L’orientation du nœud de l’espace de travail devient verticale. La fenêtre de terminal que vous avez déplacée vers le bas est directement attachée à l'espace de travail et apparaît en bas de l'écran. Un nouveau container (horizontal) a été créé pour accueillir les deux autres fenêtres de terminal. Vous le remarquerez lors du passage en mode tabulé (par exemple). Vous finiriez par avoir un onglet avec une représentation du container divisé (par exemple, "H [urxvt firefox]") et l'autre étant la fenêtre de terminal que vous avez déplacée vers le bas.

Il est possible et recommandé d'utiliser des commentaires dans votre fichier de configuration pour documenter correctement votre configuration pour référence ultérieure. Les commentaires commencent par un # et ne peuvent être utilisés qu'au début d'une ligne:

Exemple :

i3 supporte les polices X core fonts et FreeType fonts (grâce à Pango) pour afficher les titres des fenêtres.

Pour générer la description d'une police X core font, vous pouvez utiliser xfontsel(1). Pour afficher es caractères spéciaux, vous devez utiliser une police qui supporte l'encodage ISO-10646.

Une description de police FreeType est composée d'une famille de polices, d'un style, d'un poids, d'une variante, d'un étirement et d'une taille. Les polices FreeType prennent en charge le rendu de droite à gauche et contiennent souvent plus de glyphes Unicode que les polices X core.

Si i3 ne peut pas ouvrir la police configurée, il affichera une erreur dans le fichier journal et reviendra à une police fonctionnelle.

Syntaxe :

Exemples :

Un raccourcis clavier demandera à i3 d'exécuter une commande en pressant certaines touches. i3 vous permet d'utiliser les keycodes ou les keysyms (vous pouvez même utiliser les deux car i3 ne vous empêche pas d'écraser les raccourcis par défaut).

Ma recommandation est la suivante : si vous changez souvent de disposition de clavier mais que vous souhaitez conserver vos raccourcis au même emplacement physique sur le clavier, utilisez des codes clavier (keycodes). Si vous ne changez pas de disposition et que vous voulez un fichier de configuration propre et simple, utilisez les mots clés (keysym).

Certains outils (comme import ou xdotool) pourrait ne pas répondre à la pression d'un touche (KeyPress event), car le clavier/souris est encore en fonction. Pour ces cas de figure, l'option --release peut être utilisée afin que la commande soit lancée une fois les touches relachées.

Syntaxe :

Exemples :

Touches de modification :

Un raccourcis à la souris permet à i3 d'exécuter une action sur le container dans lequel se trouve le pointeur à la pression d'un bouton (voir [command_criteria]). Vous pouvez configurer vos raccourcis à la souris comme vos raccourcis clavier.

Syntaxe :

Par défaut, le raccourcis ne fonctionnera que si vous cliquez sur la barre de titre d'une fenêtre. Si l'option --release est utilisée, l'action sera exécutée en relâchant le bouton de la souris.

Si l'option --whole-window est utilisée, l'action sera exécutée quel que soit l'endroit où le pointeur se trouve, exception faite des bordures. Pour une action exécutée depuis une bordure, utilisez l'option --border.

Si l'option --exclude-titlebar est utilisée, la barre de titre ne sera pas active pour exécuter un raccourcis.

Exemples :

Vous pouvez avoir plusieurs ensembles de raccourcis en utilisant différentes chaines de raccoucis. Lorsque vous passez à une autre chaine de raccourcis, tous les raccourcis de la chaine actuelle sont libérées et seuls les raccourcis définis dans la nouvelle chaine sont valides tant que vous restez dans cette chaine de raccoucis. La seule chaine préconfigurée est default, qui est le mode dans lequel i3 démarre et dans lequel tous les raccourcis sont configurés.

Travailler avec les chaines de raccourcis comporte deux parties : définir une chaine de raccourcis et l'activer. Pour cela, il existe une directive de configuration et une commande, toutes deux appelées mode. La directive est utilisée pour définir les raccourcis appartenant à une certaine chaine de raccourcis, tandis que la commande passera sur la chaine spécifiée.

Il est recommandé d'utiliser les chaines de raccourcis en combinaison avec les [variables] pour favoriser la maintenance. Voici en exemple d'utilisation des chaines de raccourcis.

Notez qu'il est conseillé de définir des raccourcis pour revenir au mode par défaut.

Notez qu'il est possible d'utiliser [pango_markup] pour les raccourcis clavier, mais vous devrez explicitement utiliser l'option --pango_markup pour activer le mode.

Syntaxe :

Exemple :

Pour déplacer des fenêtres flottantes avec votre souris, vous pouvez soit saisir leur barre de titre, soit configurer le modificateur flottant sur lequel vous pouvez ensuite appuyer et cliquer n'importe où dans la fenêtre elle-même pour la déplacer. La configuration la plus courante consiste à utiliser la même touche que celle que vous utilisez pour gérer les fenêtres (Mod1, Alt par exemple). Ensuite, vous pouvez appuyer sur Mod1, cliquer dans une fenêtre à l'aide du bouton gauche de la souris et le faire glisser vers la position souhaitée.

Lorsque vous maintenez le modificateur flottant, vous pouvez redimensionner une fenêtre flottante en appuyant sur le bouton droit de la souris et en vous déplaçant tout en le maintenant. Si vous maintenez également le bouton Shift enfoncé, le redimensionnement sera proportionnel (le rapport hauteur/largeur sera conservé).

Syntaxe :

Exemple :

Les dimensions maximales et minimales des fenêtres flottantes peuvent être spécifiées. Si une dimension floating_maximum_size est spécifiée à -1, cette dimensions ne sera pas contrainte et respectera sa valeur par défaut. Si une dimension floating_maximum_size est indéninie ou specifiée à 0, i3 utilisera une valeur par défaut pour contraindre les dimensions de la fenêtre. floating_minimum_size fonctionne comme floating_maximum_size.

Syntaxe :

Exemple :

Les nouveaux espaces de travail ont une orientation logique par défaut: les moniteurs à écran large (tout ce qui est plus large que haut) ont une orientation horizontale, les moniteurs pivotés (tout ce qui est plus haut que large) ont une orientation verticale.

Grâce à l'option default_orientation, vous pouvez modifier ce comportement.

Syntaxe :

Exemple :

Cette option détermine la disposition par défaut des nouveaux containers dans l'espace de travail.

Syntaxe :

Exemple :

Cette option détermine la position du titre d'une fenêtre (par défaut à gauche).

Syntaxe :

Cette option détermine l'apparence des bordures par défaut pour les fenêtres. Par default, c'est normal. Notez que default_floating_border ne s'applique qu'aux fenêtres ouvertes déjà flottantes comme les fenêtres de dialogue, mais pas aux fenêtres que vous passez en mode flottant.

Définir le style de bordure sur pixel élimine la barre de titre. Le style normal vous permet d'ajuster l'épaisseur des bordures tout en gardant la barre de titre.

Syntaxe :

Notez que les options new_window et new_float sont dépréciées en faveur des options ci-dessous et seront supprimées dans une prochaine version.

Exemple :

Les styles de bordure "normal" et "pixel" supportent une option additionnelle en pixels :

Exemple :

Vous pouvez masquer les bordures des fenêtres sur les bords d'écran avec l'option hide_edge_borders. Ceci est utile si vous utilisez des barres de défilement ou si vous ne voulez pas gaspiller deux pixels de votre écran. Le paramètre "smart" masque les bordures des espaces de travail avec une seule fenêtre visible, mais les garde sur les espaces de travail avec plusieurs fenêtres visibles. La valeur par défaut est "none".

Syntaxe :

Exemple :

Avec la directive for_window, vous pouvez demander à i3 d'exécuter n'importe quelle commande au lancement d'une fenêtre spécifique. Ceci peut être utile pour forcer une fenêtre flottante ou pour changer le style de bordure, par exemple.

Syntaxe :

Exemples :

Les options sont les mêmes que pour la fonction "commande", voir [command_criteria]. Seules des commandes peuvent être exécutées, pas des directives, voir [list_of_commands].

Lorsqu'une nouvelle fenêtre s'affiche, elle capte le focus. La directive no_focus permet d'éviter ce comportement et doit être utilisée en combinaison avec une commande [command_criteria].

Notez que cela ne s'applique pas dans tous les cas, par exemple, si une fenêtre s'active lors d'une action, elle obtiendra la focus. Pour configurer le comportement dans un tel cas, utilisez [focus_on_window_activation].

no_focus sera aussi ignoré lorsqu'une seule f enêtre s'ouvre sur un espace de travail, car elle n'a aucune raison de ne pas obtenir le focus. Cela permet une meilleure utilisation en conbinaison avec workspace_layout.

Syntaxe :

Exemple :

Comme vous l'avez appris dans la section sur les raccourcis clavier, vous pouvez configurer de nombreux raccourcis contenant des touches de modification. Si vous souhaitez vous épargner de la saisie et pouvoir changer le modificateur que vous utilisez plus tard, les variables peuvent être utiles.

Syntaxe :

Exemple :

Les variables sont directement remplacées dans le fichier lors de l'analyse. Le développement des variables n'est pas récursif, il n'est donc pas possible de définir une variable avec une valeur contenant une autre variable. Il n'y a pas de manipulation sophistiquée et il n'est absolument pas prévu de changer cela. Si vous avez besoin d'une configuration plus dynamique, vous devez créer un petit script qui génère un fichier de configuration et l'exécuter avant de démarrer i3 (par exemple dans votre fichier ~/.xsession).

Voir aussi le chapitre [xresources] pour apprendre à créer des variables basées sur des ressources chargées à partir de la base de données de ressources X (section suivante).

[variables] peuvent également être créées à l'aide d'une valeur configurée dans la base de données Xressources. Ceci est utile, par exemple, pour éviter de configurer des valeurs de couleur dans la configuration i3. Au lieu de cela, les valeurs peuvent être configurées, une fois, dans la base de données de Xressources pour obtenir un thème de couleur cohérent et facilement maintenable dans de nombreuses applications X.

La définition d'une ressource chargera cette ressource à partir de la base de données et attribuera sa valeur à la variable spécifiée. Cela se fait textuellement et la valeur doit donc être au format utilisé par i3. Une solution de rechange doit être spécifiée au cas où la ressource ne puisse pas être chargée à partir de la base de données.

Syntaxe :

Exemple :

Pour placer une fenêtre spécifique sur un espace de travail donné, vous utiliserez l'option assignment. Vous pouvez désigner une fenêtre en utilisant un ou plusieurs critères, voir[command_criteria]. La différence entre assign et for_window <criteria> move to workspace est que l'action ne s'applique pas uniquement à l'ouverture de le fenêtre, mais aussi lorsqu'une fenêtre change ses propriétés et correspond à un des critères spécifiés.

Ainsi, il est recommandé de faire correspondre les classes de fenêtre (et les instances, le cas échéant) au lieu des titres de fenêtre chaque fois que possible car certaines applications créent d'abord leur fenêtre, puis s'inquiètent de définir le titre correct. Firefox et Vimperator par exemple : la fenêtre s'ouvre sous le nom de Firefox, et ce n'est que lorsque Vimperator est chargé que le titre change. Comme i3 recevra le titre dès que l'application affichera la fenêtre, vous devrez dans ce cas faire correspondre Firefox. Un autre problème connu concerne Spotify, qui ne définit pas les indices de classe lors de l'affichage de la fenêtre, ce qui signifie que vous devrez utiliser une règle for_window pour attribuer Spotify à un espace de travail spécifique. Pour finir, utiliser assign [tiling] et assign [floating] n'est pas supporté.

Vous pouvez aussi désigner une fenêtre pour qu'elle s'affiche sur un écran spécifique. Vous pouvez utiliser le nom RandR comme VGA1 ou un nom relatif à l'éran contenant la fenêtre détenant actuellement le focus comme left et down.

Les assignations sont traitées par i3 dans l'ordre dans lequel elles apparaissent dans le fichier de configuration. Le premier qui correspond à la fenêtre gagne et les affectations ultérieures ne sont pas prises en compte.

Syntaxe :

Exemples :

Notez que vous n'avez peut-être pas encore configuré d'écran principal. Pour ce faire, exécutez :

La petite flêche n'est pas obligatoire, c'est simplement pour faire joli :-). Si vous voulez l'employer, prenez soin d'utiliser une flêche encodée en UTF-8, pas -> ou un truc du genre.

Pour obtenir la class et l'instance, vous pouvez utiliser xprop. Après avoir cliqué sur une fenêtre, vous obtiendrez ses informations dans ce style :

xprop :

La première partie de WM_CLASS est l'instance ("irssi" dans notre exemple), la seconde partie est la class ("URxvt" dans notre exemple).

Si vous avez le moindre soucis avec les assignements, vérifiez tout d'abord le fichier de log i3 (voir https://i3wm.org/docs/debugging.html). Il contient plus de détails à propos du processus d'assignement et les renseignements sur la class, l'instance et le titre des fenêtres.

Notez que si vous souhaitez démarrer une application une seule fois sur un espace de travail spécifique, mais que vous ne souhaitez pas attribuer ce comportement à toutes les instances de manière permanente, vous pouvez utiliser la prise en charge des notifications de démarrage d'i3 (voir [exec]) dans votre fichier de configuration de la manière suivante :

Lancer iceweasel sur l'espace de travail 3 (une seule fois) :

En utilisant la commande exec en dehors du contexte des raccourcis clavier, vous pouvez configurer quelles applications seront lancées au démarrage d'i3. exec ne sera pas actif lors d'un rechargement d'i3, si vous désirez que la commande soit exécutée de nouveau lors du rechargement d'i3, utilisez exec_always. Ces commandes seront lancées dans l'ordre d'apparition dans le fichier de configuration.

Voir la section [command_chaining] pour plus de détails sur l'utilisation de ; (semicolon) et , (comma) : ils lient les commandes sur i3, donc vous devez utiliser des guillemets "" si une commande les contient (voir [exec_quoting]).

Syntaxe :

Exemples :

L'option --no-startup-id est expliquée ici : [exec].

Si vous affectez des clients à des espaces de travail, il peut être pratique de placer les espaces de travail sur des écrans spécifiques. En outre, l'assignation d'espaces de travail aux écrans déterminera quel espace de travail i3 utilise lors du branchement d'un écran ou au démarrage (par exemple, il utilisera 1 pour le premier écran, 2 pour le deuxième écran et ainsi de suite).

Syntaxe :

L'écran output est le nom que RandR donne à votre écran. Pour un ordinateur portable, vous devriez utiliser VGA1 et LVDS1 comme noms d'écran. Vous pouvez lister les écrans actifs avec xrandr --current.

Si votre serveur X supporte RandR 1.5 ou supérieur, i3 utilisera la fonction monitor de RandR au lieu de la fonction output. Utilisez xrandr --listmonitors pour afficher la liste. En général, un monitor contient un seul output et a le même nom; mais si ce n'est pas le cas, vous pouvez spécifier le nom du moniteur ou de la sortie dans la configuration d'i3. Par exemple, le Dell UP2414Q utilise deux dénominations en interne, de sorte que ses noms de sortie peuvent être «DP1» et «DP2», mais le nom du moniteur est «Dell UP2414Q».

(Notez que même si vous spécifiez le nom d'une sortie qui ne couvre pas tout le moniteur, i3 utilisera toujours la zone entière du moniteur contenant plutôt que celle de la sortie uniquement.)

Vous pouvez spécifiez plusieurs écrans. Le premier disponible sera utilisé.

Si vous utilisez le nom des espaces de travail, vous devez utiliser des guillements :

Exemples :

Vous pouvez modifier chaque couleur utilisée par i3 pour décorer les fenêtres.

Syntaxe :

Avec colorclass pouvant être un de ceux-ci :

Les couleurs sont indiquées au format HTML (#rrggbb), voir l'exemple suivant :

Exemples (couleurs par défaut) :

Notez que pour les décorations de fenêtre, la couleur autour de la fenêtre enfant est "child_border", et la couleur "border" représente les deux fines lignes autour de la barre de titre.

La couleur de l'indicateur est utilisée pour indiquer où une nouvelle fenêtre sera ouverte. Pour les containers fractionnés horizontaux, la bordure droite sera peinte dans la couleur de l'indicateur, pour les containers fractionnés verticaux, la bordure inférieure. Cela ne s'applique qu'aux fenêtres simples dans un container divisé, qui sont autrement impossibles à distinguer des fenêtres simples à l'extérieur d'un container divisé.

i3 utilise des sockets Unix pour fournir une interface IPC. Cela permet à des programmes tiers d'obtenir des informations d'i3, telles que les espaces de travail actuels (pour afficher une barre d'espace de travail), et de contrôler i3.

Le socket IPC est activé par défaut et sera créée dans $XDG_RUNTIME_DIR/i3/ipc-socket.%p si le répertoire est disponible, en revenant à /tmp/i3-%u.XXXXXX/ipc-socket.%p, où %u est votre nom d'utilisateur UNIX, %p est le PID de i3 et XXXXXX est une chaîne de caractères aléatoires du jeu de caractères du nom de fichier portable (voir mkdtemp(3)).

Vous pouvez modifier le chemin par défaut via la variable d'environnement I3SOCK ou en spécifiant la directive ipc-socket. Ceci n'est pas encouragé, car i3 se comporte correctement par défaut. Si vous décidez de le changer, il est fortement recommandé de le définir sur un emplacement dans votre répertoire personnel afin qu'aucun autre utilisateur ne puisse créer ce répertoire.

Exemples :

Vous pouvez utiliser l'application i3-msg pour exécuter les commandes listées dans [list_of_commands].

Par défaut, le focus suit les mouvements de votre souris lorsque le pointeur traverse les bordures de la fenêtre. Cependant, si vous avez une configuration où votre souris est trop sur votre chemin (comme un pavé tactile sur votre ordinateur portable que vous ne souhaitez pas désactiver complètement), vous pouvez désactiver focus_follow_mouse et contrôler le focus uniquement en utilisant votre clavier. La souris sera toujours utile dans la fenêtre active (par exemple pour cliquer sur des liens dans la fenêtre de votre navigateur).

Syntaxe :

Exemple :

Par défaut, lors du passage du focus à une fenêtre sur un écran différente (par exemple, focalisation d'une fenêtre sur l'espace de travail 3 sur la sortie VGA-1, provenant de l'espace de travail 2 sur LVDS-1), le curseur de la souris est capté et s'affiche au centre de cette fenêtre.

Avec l'option mouse_warping , vous pouvez décider quand votre pointeur sera capté. none désactive totalement la captation, quel que soit le output par défaut défini ci-dessous.

Syntaxe :

Exemple :

Lorsque vous êtes en mode plein écran, certaines applications ouvrent encore des fenêtres contextuelles (comme Xpdf par exemple). Cela est dû au fait que ces applications peuvent ne pas savoir qu'elles sont en mode plein écran (elles ne vérifient pas l'indication correspondante). Il y a trois choses à faire dans cette situation:

Syntaxe :

Exemple :

Par défaut, dans un container avec plusieurs fenêtres ou containers enfants, la fenêtre opposée sera focalisée lors de la tentative de déplacer le focus sur le bord d'un container (et qu'il n'y a aucun autre container dans cette direction) - le focus repart dans un cycle.

Vous pouvez modifier ce comportement en configurant l'option focus_wrapping sur no.

Lorsqu'il est activé, focus_wrapping ne se produit pas par défaut s'il existe une autre fenêtre ou container dans la direction spécifiée, et le focus sera à la place définie sur cette fenêtre ou ce container. Il s'agit du comportement par défaut afin que vous puissiez accéder à toutes vos fenêtres sans avoir à utiliser le focus parent.

Si vous désirez activer le focus_wrapping de façon permanente et que vous êtes à l'aise avec la fonction focus parent pour vous déplacer dans les containers, vous pouvez définir l'option focus_wrapping sur force.

Pour restreindre le focus à l'intérieur d'un espace de travail, vous devez configurez l'option focus_wrapping sur workspace. Vous devrez alors utiliser focus parent pour remonter le focus jusqu'au niveau d'un espace de travail pour ensuite déplacer le focus sur un autre espace de travail avec la commande de focus. (la commande workspace fonctionnera toujours comme prévu).

Syntaxe :

Exemples :

Comme expliqué ici https://i3wm.org/docs/multi-monitor.html, certains drivers X11 (particulièrement les drivers nVidia) supportent uniquement Xinerama et non RandR. Dans cette situation, i3 doit être prévenu explicitement afin d'utiliser le support inférieur pour l'API Xinerama et de ne pas recharger les écrans à la volée (ils seront configurés une seule fois au lancement d'i3).

Pour les personnes ne pouvant pas utiliser le fichier ~/.xsession pour y ajouter --force-xinerama, i3 propose une option :

Syntaxe :

Exemple :

Notez que vos écrans ne seront pas nommés avec Xinerama (comme HDMI1), ils sont numérotés en commençant par 0 : xinerama-0, xinerama-1, …

La configuration permet d'activer le retour automatique sur le dernier espace de travail (workspace back_and_forth voir [back_and_forth]) lorsqu'on visite un autre espace de travail.

Par exemple : imaginons que vous êtes sur l'espace de travail "1: www" et que vous passez sur l'espace de travail "2: IM" en utilisant mod+2 car un humain vous a envoyé un message. Vous n'avez pas besoin de vous souvenir sur quel espace de travail vous étiez, il vous suffit de presser $mod+2 une nouvelle fois pour revenir sur l'espace de travail "1: www".

Syntaxe :

Exemple :

Si une application sur un autre espace de travail envoie un indice d'urgence, le passage à cet espace de travail peut conduire à un focus immédiat de l'application, ce qui signifie également que la couleur de la décoration de la fenêtre serait immédiatement réinitialisée sur client.focused. Cela peut rendre inutilement difficile de dire quelle fenêtre a déclenché l'urgence à l'origine.

Afin d'éviter cela, vous pouvez dire à i3 de retarder la réinitialisation de l'état d'urgence d'un certain temps en utilisant la directive force_display_urgency_hint. La définition de la valeur sur 0 désactive cette fonction.

Par défaut, l'urgence disparaît au bout de 500ms.

Syntaxe :

Exemple :

Lorsqu'une fenêtre est activée, par exemple via firefox nakedeb.arpinux.org, elle va demander à capter le focus. Si vous désirez modifier ce comportement, plusieurs options existent.

Notez que cela n'affecte pas les fenêtres qui se lancent. Pour empêcher une fenêtre qui s'ouvre de réclamer le focus, voir [no_focus].

Syntaxe :

Explications des différents modes :

Si activé, les marques (voir [vim_like_marks]) sur les fenêtres sont dessinées dans leur décoration de fenêtre. Cependant, toute marque commençant par un underscore dans son nom (_) ne sera pas dessinée même si cette option est activée.

L'option par défaut est yes.

Syntaxe :

Exemple :

Les fichiers de configuration prennent en charge la continuation de ligne, ce qui signifie que lorsque vous terminez une ligne par une barre oblique inverse (\), le saut de ligne sera ignoré par l'analyseur. Cette fonctionnalité peut être utilisée pour créer des fichiers de configuration plus lisibles. Les lignes commentées ne sont pas poursuivies.

Exemples :

Par défaut, i3 passera simplement i3bar et laissera votre shell gérer l'exécution, en recherchant dans votre $PATH pour une version exploitable. Si vous avez une autre version d'i3bar quelque part ou si le binaire n'est pas dans votre $PATH, vous pouvez indiquer à i3 quelle commande exécuter.

La commande spécifiée sera transmise à sh -c, vous pouvez donc utiliser le globbing et avoir des guillemets corrects etc.

Syntaxe :

Exemple :

i3bar peut exécuter un programme et afficher chaque ligne de sa sortie stdout sur le côté droit de la barre. Ceci est utile pour afficher les informations système telles que votre adresse IP actuelle, l'état de la batterie ou la date et l'heure.

La commande spécifiée sera transmise à sh -c, vous pouvez donc utiliser le globbing et avoir des guillemets corrects etc. Notez que pour la gestion du signal, en fonction de votre shell (les utilisateurs de dash(1) sont connus pour être affecté), vous devez utiliser la commande exec du shell pour que les signaux soient transmis à votre programme, pas au shell.

Syntaxe :

Exemple :

Vous pouvez soit avoir i3bar soit visible en permanence sur un bord de l'écran (mode dock) ou le faire apparaître lorsque vous appuyez sur votre touche de modification (mode hide). Il est également possible de forcer i3bar à toujours rester caché (mode invisible). La touche de modification peut être configurée à l'aide de l'option modifier.

Le mode d'affichage peut être modifié pendant l'exécution via la commande bar mode. Au rechargement, le mode reviendra à sa valeur configurée.

Le mode hide maximise l'espace d'écran qui peut être utilisé pour les fenêtres réelles. En outre, i3bar envoie les signaux SIGSTOP et SIGCONT au processus de la barre d'état pour économiser l'énergie de la batterie.

Le mode invisible permet de maximiser en permanence l'espace de l'écran, car la barre n'est jamais affichée. Ainsi, vous pouvez configurer i3bar pour ne pas vous déranger en apparaissant à cause d'un indice d'urgence ou parce que la touche de modification est enfoncée.

Afin de contrôler si i3bar est masqué ou affiché en mode hide, il existe l'option hidden_state, qui n'a aucun effet en mode dock ou en mode invisible. Il indique l'état caché actuel de la barre : (1) La barre agit comme en mode caché normal, elle est cachée et n'est affichée qu'en cas d'indices d'urgence ou en appuyant sur la touche de modification (état hide), ou (2) il est dessiné sur l'espace de travail actuellement visible (état show).

Comme le mode, hidden_state peut également être contrôlé via i3, en utilisant la commande bar hidden_state.

Le mode par défaut est le mode dock; en mode hide, le modificateur par défaut est Mod4 (généralement la touche Windows). La valeur par défaut de hidden_state est hide.

Syntaxe :

Exemple :

Les modificateurs disponibles sont Mod1-Mod5, Shift, Control (voir xmodmap (1)). Vous pouvez également utiliser "none" si vous ne souhaitez pas qu'un modificateur déclenche ce comportement.

Spécifier une commande à exécuter lors d'un clic sur i3bar pour remplacer le comportement par défaut peut être utile, par exemple, pour désactiver l'action de la molette de défilement ou exécuter des scripts qui implémentent un comportement personnalisé pour ces boutons.

Un bouton est toujours nommé button<1-5>, où 1 à 5 sont les boutons par défaut comme suit et les nombres plus élevés peuvent être des boutons spéciaux sur les appareils offrant plus de boutons:

Veuillez noter que les anciennes commandes wheel_up_cmd et wheel_down_cmd sont obsolètes et seront supprimées dans une prochaine version. Nous vous recommandons fortement d'utiliser plutôt le bindsym plus général avec button4 et button5.

Syntaxe :

Exemple :

Spécifie l'ID de barre pour l'instance de barre configurée. Si cette option est manquante, l'ID est défini sur bar-x, où x correspond à la position du bloc de barres dans le fichier de configuration (bar-0, bar-1, etc).

Syntaxe :

Exemple :

Cette option détermine l'emplacement de la barre sur l'écran.

Par défaut : bottom.

Syntaxe :

Exemple :

Vous pouvez restreindre i3bar à une ou plusieurs sorties (moniteurs). La valeur par défaut est de gérer toutes les sorties. La limitation des sorties est utile pour utiliser différentes options pour différentes sorties en utilisant plusieurs blocs bar.

Pour qu'une instance i3bar particulière gère plusieurs sorties, spécifiez la directive de sortie plusieurs fois.

Syntaxe :

Exemple :

Notez que vous n'avez peut-être pas encore configuré de sortie principale. Pour ce faire, exécutez :

i3bar par défaut fournit une zone de notification où des programmes tels que NetworkManager, VLC, Pidgin, etc. peuvent placer de petites icônes.

Vous pouvez configurer sur quelle sortie (moniteur) les icônes doivent être affichées ou vous pouvez désactiver complètement la fonctionnalité.

Vous pouvez utiliser plusieurs directives tray_output dans votre configuration pour spécifier une liste de sorties sur lesquelles vous voulez que la zone apparaisse. La première sortie disponible dans cette liste telle que définie par l'ordre des directives sera utilisée pour la zone de notification.

Syntaxe :

Exemple :

Notez que vous n'avez peut-être pas encore configuré de sortie principale. Pour ce faire, exécutez :

Notez que lorsque vous utilisez plusieurs blocs de configuration de barres, spécifiez tray_output primary dans chacun d'eux ou spécifiez explicitement tray_output none dans les barres qui ne doivent pas afficher la barre d'état, sinon les différentes instances peuvent se concurrencer en essayant d'afficher les icônes de la barre d'état.

La zone de notification est affichées sur le côté droit de la barre. Par défaut, une marge de 2 pixels est utilisée pour le côté supérieur, inférieur et droit de la zone de notification et entre les icônes.

Syntaxe :

Exemple :

Spécifie la police à utiliser dans la barre. Voir [fonts].

Syntaxe :

Exemple :

Spécifie un symbole personnalisé à utiliser pour le séparateur par opposition au séparateur vertical d'un pixel par défaut.

Syntaxe :

Exemple :

Spécifie si les boutons de l'espace de travail doivent être affichés ou non. Ceci est utile si vous souhaitez afficher une barre d'état contenant uniquement des informations supplémentaires.

Par défaut, les boutons des espaces de travail sont affichés.

Syntaxe :

Exemple :

Par défaut, la largeur d'un bouton d'espace de travail est déterminée par la largeur du texte affichant le nom de l'espace de travail. Si le nom est trop court (par exemple, une lettre), le bouton de l'espace de travail peut paraître trop petit.

Cette option spécifie la largeur minimale des boutons de l'espace de travail. Si le nom d'un espace de travail est trop court pour couvrir le bouton, un remplissage supplémentaire est ajouté des deux côtés du bouton afin que le texte soit centré.

La valeur par défaut de zéro signifie qu'aucun remplissage supplémentaire n'est ajouté.

Le réglage s'applique également à l'indicateur de mode de raccourcis actif.

Notez que les pixels spécifiés font référence à des pixels logiques, ce qui peut se traduire par plus de pixels sur les écrans HiDPI.

Syntaxe :

Exemple :

Spécifie si les numéros d'espace de travail doivent être affichés dans les boutons de l'espace de travail. Ceci est utile si vous souhaitez avoir un espace de travail nommé qui reste dans l'ordre sur la barre en fonction de son numéro sans afficher le préfixe numérique.

Lorsque strip_workspace_numbers est défini sur yes, tout espace de travail dont le nom est de la forme "[n] [:] [NAME]" affichera uniquement le nom. Vous pouvez utiliser ceci, par exemple, pour afficher des chiffres romains plutôt que des chiffres en nommant vos espaces de travail «1: I», «2: II», «3: III», «4: IV», etc.

Lorsque strip_workspace_name est défini sur yes, tout espace de travail dont le nom est de la forme "[n] [:] [NAME]" affichera uniquement le numéro.

La valeur par défaut est d'afficher le nom complet dans le bouton de l'espace de travail. Sachez que les deux points dans le nom de l'espace de travail sont facultatifs, donc [n] [NAME] aura également le nom et le numéro de l'espace de travail supprimés correctement.

Syntaxe :

Exemple :

Spécifie si l'indicateur de mode de raccourcis actif doit être affiché ou non. Cela est utile si vous souhaitez masquer les boutons de l'espace de travail tout en continuant à voir l'indicateur de mode de raccourcis. Voir [binding_modes] pour découvrir ce que sont les modes et comment les utiliser.

Par défaut, l'indicateur est affiché.

Syntaxe :

Exemple :

Sur i3, les couleurs sont au format HTML hexadécimal (#rrggbb). Les couleurs suivantes peuvent être configurées :

Syntaxe :

Exemple (couleurs par défaut) :

i3bar peut prendre en charge la transparence en passant l'indicateur --transparency dans la configuration :

Syntaxe :

Dans la configuration des couleurs i3bar et l'attribut de couleur du bloc d'état i3bar, vous pouvez ensuite utiliser des couleurs au format RGBA, c'est-à-dire que les deux derniers chiffres (hexadécimaux) spécifient l'opacité. Par exemple, #00000000 sera complètement transparent, tandis que #000000FF sera un noir complètement opaque (le même que #000000).

Veuillez noter qu'en raison du fonctionnement de la zone de notification, l'activation de cet indicateur fera en sorte que toutes les icônes de la zone auront un arrière-plan transparent.

À quoi sert un gestionnaire de fenêtres si vous ne pouvez pas démarrer d’applications ? La commande exec démarre une application en passant la commande que vous spécifiez à un shell. Cela implique que vous pouvez utiliser le globbing (caractères génériques) et que les programmes seront recherchés dans votre $PATH.

Voir [command_chaining] pour savoir comment utiliser ; (semicolon) et , (comma) : ils lient les commandes sur i3, donc vous devrez utiliser des guillemets (voir [exec_quoting]) si vous les utilisez dans vos commandes.

Syntaxe :

Exemple :

Le paramètre --no-startup-id désactive la prise en charge de la notification de démarrage pour cette commande exec particulière. Avec la notification de démarrage, i3 peut s'assurer qu'une fenêtre apparaît sur l'espace de travail sur lequel vous avez utilisé la commande exec. De plus, cela changera le curseur X11 en watch (horloge) pendant le lancement de l'application. Donc, si une application ne prend pas en charge les notifications de démarrage (la plupart des applications utilisant GTK et Qt semblent l'être), vous vous retrouverez avec un curseur en horloge pendant 60 secondes.

Si la commande à exécuter contient un ; (point-virgule) et/ou un , (virgule), la commande entière doit être entre guillemets. Par exemple, pour avoir un raccourci clavier pour la commande shell notify-send Hello, i3, vous ajouteriez une entrée à votre fichier de configuration comme ceci :

Exemple :

Si toutefois une commande avec une virgule et/ou un point-virgule nécessite elle-même des guillemets, vous devez échapper les guillemets internes avec des doubles barres obliques inverses, comme ceci :

Exemple :

La commande de division fait de la fenêtre courante un container divisé. Les containers divisés peuvent contenir plusieurs fenêtres. Selon la disposition du container divisé, les nouvelles fenêtres sont placées à droite de celle actuelle (splith) ou les nouvelles fenêtres sont placées sous la fenêtre actuelle (splitv).

Si vous appliquez cette commande à un container divisé avec la même orientation, rien ne se passera. Si vous utilisez une orientation différente, l’orientation du container divisé sera modifiée (s’il n’a pas plus d’une fenêtre). L'option toggle changera l'orientation du container divisé s'il contient une seule fenêtre. Sinon, cela fait de la fenêtre actuelle un container divisé avec une orientation opposée par rapport au container parent. Utilisez layout toggle split pour changer la disposition de tout container divisé de splitv à splith ou vice-versa. Vous pouvez également définir une séquence personnalisée de layout à parcourir avec layout toggle, voir [manipulating_layout].

Syntaxe :

Exemple :

Utilisez layout toggle split, layout stacking, layout tabbed, layout splitv ou layout splith pour changer la disposition actuelle du container en splith/splitv, stacking, tabbed layout, splitv ou splith, respectivement.

Vous pouvez spécifier jusqu'à 4 layouts après layout toggle pour les parcourir. Chaque fois que la commande est exécutée, la mise en page spécifiée après celle actuellement active sera appliquée. Si la mise en page actuellement active n'est pas dans la liste, la première mise en page de la liste sera activée.

Pour afficher la fenêtre active en plein écran, utilisez fullscreen enable (ou fullscreen enable global pour le mode global), pour quitter l'un ou l'autre des modes plein écran, utilisez fullscreen disable, et pour basculer entre ces deux états, utilisez fullscreen toggle (ou fullscreen toggle global).

De la même façon, pour libérer une fenêtre, ou la paver, utilisez floating enable ou floating disable respectivement. (ou floating toggle):

Syntaxe :

Exemples :

Pour passer le focus, utilisez la commande focus. Les options suivantes sont disponibles :

Syntaxe :

Exemples :

Notez que vous n'avez peut-être pas encore configuré de sortie principale. Pour ce faire, exécutez:

Utilisez la commande move pour déplacer un container.

Syntaxe :

Exemples :

Deux containers peuvent être échangés (c'est-à-dire se déplacer l'un vers l'autre) en utilisant la commande swap. Ils prendront la position et la géométrie du container avec lequel ils sont échangés.

Le premier container à participer à l'échange peut être sélectionné via le processus de critères de commande normal, la fenêtre focalisée étant la solution de secours habituelle si aucun critère n'est spécifié. Le deuxième container peut être sélectionné à l'aide de l'une des méthodes suivantes :

Notez que l'échange ne fonctionne pas avec tous les containers. Plus particulièrement, l'échange de containers qui ont une relation parent-enfant entre eux ne fonctionne pas.

Syntaxe :

Exemples :

Si vous voulez qu'une fenêtre "colle à la vitre", c'est-à-dire qu'elle reste à l'écran même si vous passez à un autre espace de travail, vous pouvez utiliser la commande sticky. Par exemple, cela peut être utile pour les blocs-notes, un lecteur multimédia ou une fenêtre de chat vidéo.

Notez que même si n'importe quelle fenêtre peut être r endue collante grâce à cette commande, elle ne prendra effet que si la fenêtre est flottante.

Syntaxe :

Exemples :

Pour afficher un espace de travail spécifique, utilisez la commande workspace, suivie du numéro ou du nom de l'espace de travail. Utilisez l'option facultative --no-auto-back-and-out pour désactiver [workspace_auto_back_and_forth] sur cette commande uniquement.

Pour déplacer un container sur un espace de travail spécifique, utilisez move container to workspace.

Vous pouvez aussi afficher l'espace de travail suivant ou précédent avec les commandes workspace next et workspace prev, ce qui est pratique si vous activez les espaces de travail 1, 3, 4 et 9 et que vous désirez les afficher à la suite avec un simple raccourcis clavier. Pour restreindre ce comportement au moniteur actif, utilisez workspace next_on_output et workspace prev_on_output. De la même façon, vous pouvez utiliser move container to workspace next, move container to workspace prev pour déplacer un container sur l'espace de travail suivant/précédent et move container to workspace current (Le dernier n'a de sens que s'il est utilisé avec des critères).

workspace next fait défiler les espaces de travail numérotés ou nommés. Mais lorsqu'il atteint le dernier espace de travail numéroté/nommé, il recherche les espaces de travail nommés après avoir épuisé les espaces numérotés et recherche les espaces numérotés après avoir épuisé les espaces nommés.

Voir [move_to_outputs] pour savoir comment déplacer un container sur un moniteur RandR différent.

Les espaces de travail sont lus par i3bar selon Pango markup.

Pour revenir au dernier espace de travail focalisé, utilisez workspace back_and_forth; Grâce à ça, vous pouvez déplacer un container vers le dernier espace de travail focalisé avec la commande move container to workspace back_and_forth.

Syntaxe :

Exemples :

Voir [move_to_outputs] pour découvrir comment déplacer un espace de travail sur un moniteur RandR différent.

Pour déplacer un container vers une autre sortie RandR (identifiée par des noms comme LVDS1 ou VGA1) ou vers une sortie RandR identifiée par une direction spécifique (comme left, right, up ou down), il y a deux commandes :

Syntaxe :

Exemples :

Notez que vous n'avez peut-être pas encore configuré de sortie principale. Pour ce faire, exécutez :

Pour déplacer un container vers une marque (voir [vim_like_marks]), vous pouvez la commande suivante.

La fenêtre sera déplacée juste après le container marqué dans l'arborescence, c'est à dire qu'elle se terminera dans la même position que si vous aviez ouvert une nouvelle fenêtre lorsque le container marqué était sélectionné. Si la marque est sur un container divisé, la fenêtre apparaîtra comme un nouvel enfant après l'enfant actuellement focalisé dans ce container.

Syntaxe :

Exemple :

Si vous désirez redimensionner un container ou une fenêtre depuis votre clavier, vous pouvez utiliser la commande resize :

Syntaxe :

La direction peut être up, down, left ou right. Ou peut être moins spécifique et utiliser width ou height, au quel cas, i3 prendra/rendra l'espace sur les autres containers. L'option additionnelle 'pixel' détermine la taille du redimensionnement (par défaut 10 pixels). L'argument facultatif 'ppt' signifie "points de pourcentage", et s'il est spécifié, il indique qu'un tiling container doit être agrandi ou réduit de autant de points, au lieu de la valeur px.

À propos de resize set : 0 pour <width> ou <height> signifie "ne pas redomensionner dans cette direction".

Il est recommandé d'utiliser une chaine de raccourcis pour le redimensionnement. Voir [binding_modes] et l'exemple dans la configuration d'i3.

Exemple :

Souvent, dans un environnement à plusieurs moniteurs, vous souhaitez accéder rapidement à une fenêtre spécifique. Par exemple, lorsque vous travaillez sur l’espace de travail 3, vous souhaiterez peut-être accéder à votre client de messagerie pour envoyer un e-mail à votre patron à propos d'un objectif important. Au lieu de savoir comment accéder à votre client de messagerie, il serait plus pratique d'avoir un raccourci. Vous pouvez utiliser la commande focus avec des critères pour cela.

Syntaxe :

Exemples :

Cette fonctionnalité est comme la fonction de saut : elle vous permet de sauter directement à une fenêtre spécifique (cela signifie passer à l'espace de travail approprié et définir le focus sur la fenêtre). Vous pouvez directement marquer une fenêtre spécifique avec une étiquette arbitraire et l'utiliser ensuite. Vous pouvez décocher l'étiquette de la même manière, à l'aide de la commande unmark. Si vous ne spécifiez pas d'étiquette, unmark supprime toutes les marques. Vous n'avez pas besoin de vous assurer que vos fenêtres ont des classes ou des titres uniques, et vous n'avez pas besoin de modifier votre fichier de configuration.

Comme la commande doit inclure l'étiquette avec laquelle vous souhaitez marquer la fenêtre, vous ne pouvez pas simplement la lier à une clé. i3-input est un outil créé à cet effet : il vous permet de saisir une commande et d'envoyer la commande à i3. Il peut également préfixer cette commande et afficher une invite personnalisée pour la boîte de dialogue de saisie.

L'option supplémentaire --toggle supprimera la marque si la fenêtre a déjà cette marque ou l'ajoutera autrement. Notez que vous devrez peut-être l'utiliser en combinaison avec --add (voir ci-dessous) car toute autre marque sera sinon supprimée.

L'indicateur --replace oblige i3 à supprimer toutes les marques existantes, ce qui est également le comportement par défaut. Vous pouvez utiliser l'indicateur --add pour mettre plus d'une marque sur une fenêtre.

Reportez-vous à [show_marks] si vous ne voulez pas que les marques soient affichées dans la décoration de la fenêtre.

Syntaxe :

Vous pouvez utiliser i3-input pour demander un nom de marque, puis utiliser les commandes mark et focus pour créer et accéder aux marques personnalisées :

Exemples :

Sinon, si vous ne voulez pas jouer avec i3-input, vous pouvez créer des raccourcis distincts pour un ensemble spécifique d'étiquettes, puis n'utiliser que ces étiquettes:

Exemple (dans un terminal) :

Par défaut, i3 imprimera simplement le titre de la fenêtre X11. En utilisant title_format, cela peut être personnalisé en définissant le format sur la sortie souhaitée. Cette option supporte Pango markup :

En utilisant la commande [for_window], vous pouvez modifier les titres de fenêtres en vous basant sur [command_criteria].

Syntaxe :

Exemples :

Pour changer la bordure du client actuel, vous pouvez utiliser border normal pour utiliser la bordure normale (y compris le titre de la fenêtre), border pixel 1 pour utiliser une bordure de 1 pixel (aucun titre de fenêtre) et border none pour supprimer toute bordure.

Il existe également border toggle qui permet de basculer les différents styles de bordure. L'argument pixel facultatif peut être utilisé pour spécifier la largeur de la bordure lors du passage aux styles normal et pixel.

Notez que «pixel» fait référence à un pixel logique. Sur les écrans HiDPI, un pixel logique peut être représenté par plusieurs pixels physiques, de sorte que le pixel 1 peut ne pas nécessairement se traduire en une seule ligne de 1 pixel.

Syntaxe :

Exemples :

Comme décrit dans https://i3wm.org/docs/debugging.html, i3 peut se connecter à une mémoire tampon partagée, que vous pouvez vider en utilisant i3-dump-log. La commande shmlog vous permet d'activer ou de désactiver la journalisation de la mémoire partagée lors de l'exécution.

Notez que lorsque vous utilisez shmlog <size_in_bytes>, le log courant est supprimé et un nouveau est créé.

Syntaxe :

Exemples :

La commande debuglog vous permet d'activer ou de désactiver la journalisation du débogage lors de l'exécution. La journalisation du débogage est beaucoup plus détaillée que la journalisation sans débogage. Cette commande n'active pas la journalisation de la mémoire partagée (shmlog) et, en tant que telle, est très probablement utile en combinaison avec la commande [shmlog] décrite ci-dessus.

Syntaxe :

Exemples :

Vous pouvez recharger i3 (relire le fichier de configuration) avec reload. Vous pouvez également redémarrer i3 avec la commande restart pour le sortir d'un état étrange (si cela devait arriver) ou pour effectuer une mise à niveau sans avoir à redémarrer votre session X. Pour quitter correctement i3, vous pouvez utiliser la commande exit, mais vous n’avez pas besoin de le faire (il suffit de tuer votre session X).

Exemples :

Il existe deux commandes pour utiliser n'importe quelle fenêtre existante comme scratchpad. scratchpad move déplacera une fenêtre vers l'espace de travail scratchpad. Cela le rendra invisible jusqu'à ce que vous le montriez à nouveau. Il n'y a aucun moyen d'ouvrir cet espace de travail. Au lieu de cela, lorsque vous utilisez scratchpad show, la fenêtre sera à nouveau affichée, sous la forme d'une fenêtre flottante, centrée sur votre espace de travail actuel (l'utilisation de scratchpad show sur une fenêtre de scratchpad visible le fera masqué à nouveau, vous pouvez donc avoir un raccourcis). Notez qu'il ne s'agit que d'une fenêtre flottante normale, donc si vous voulez "la supprimer du scratchpad", vous pouvez simplement la placer en mosaïque (floating toggle).

Comme son nom l'indique, c'est utile pour avoir une fenêtre avec votre éditeur préféré toujours à portée de main. Cependant, vous pouvez également l'utiliser pour d'autres applications fonctionnant en permanence que vous ne souhaitez pas voir tout le temps : votre lecteur de musique, alsamixer, peut-être même votre client de messagerie…?

Syntaxe :

Exemples :

i3 possède une commande qui ne fait rien, "no operation command" nop qui vous permet d'écraser un comportement par défaut. Cela peut être pratique pour, par exemple, désactiver le passage du focus avec le bouton central de la souris.

L'argument optionnel comment est ignoré, mais sera reporté dans le journal pour debogage.

Syntaxe :

Exemple :

Il existe deux options dans la configuration de chaque instance i3bar qui peuvent être modifiées pendant l'exécution en appelant une commande via i3. Les commandes bar hidden_state et bar mode permettent de paramétrer respectivement l'état hidden_state actuel et le mode de chaque barre. Il est également possible de basculer entre l'état hide et l'état show, ainsi qu'entre le mode dock et le mode hide. Chaque instance i3bar peut être contrôlée individuellement en spécifiant un bar_id, si aucun n'est donné, la commande est exécutée pour toutes les instances de barre.

Syntaxe :

Exemples :

Pour vous aider à démarrer si vous n'avez jamais utilisé plusieurs moniteurs auparavant, voici un bref aperçu des options xrandr qui vous intéresseront probablement. Il est toujours utile d'avoir une vue d'ensemble de la configuration actuelle de l'écran. Exécutez simplement "xrandr" et vous obtiendrez une sortie comme celle-ci :

Plusieurs choses sont importantes ici : vous pouvez voir que LVDS1 est connecté (bien sûr, c'est l'écran interne) mais que VGA1 ne l'est pas. Si vous avez un moniteur connecté à l'un des ports mais que xrandr dit toujours «déconnecté», vous devriez vérifier votre câble, moniteur ou pilote graphique.

La résolution maximale que vous pouvez voir à la fin de la première ligne est la résolution combinée maximale de vos moniteurs. Par défaut, il est généralement trop bas et doit être augmenté en éditant /etc/X11/xorg.conf.

Donc, disons que vous avez connecté VGA1 et que vous souhaitez l'utiliser comme écran supplémentaire :

Cette commande oblige xrandr à essayer de trouver la résolution native de l'appareil connecté à VGA1 et la configure à gauche de votre écran plat interne. Lorsque vous exécutez à nouveau "xrandr", la sortie ressemble à ceci :

Veuillez noter que i3 utilise exactement la même API que xrandr, donc il ne verra que ce que vous pouvez voir dans xrandr.

Voir aussi [presentations] pour plus d'exemples de configuration en mode multi-écran.

Il y a plusieurs choses à configurer dans i3 qui peuvent être intéressantes si vous avez plus d'un moniteur:

Une chose très courante parmi les utilisateurs de gestionnaires de fenêtres exotiques est une barre d'état dans un coin de l'écran. C'est un remplacement souvent supérieur à l'approche "widget" que vous avez dans la barre des tâches d'un environnement de bureau traditionnel.

Si vous n’avez pas encore votre méthode préférée pour générer une telle barre d’état (scripts auto-écrits, conky,…), alors i3status est l’outil recommandé pour cette tâche. Il a été écrit en C dans le but d'utiliser le moins d'appels système possible pour réduire le temps de réveil de votre CPU. Parce que i3status ne produit que du texte, vous devez le combiner avec un autre outil, comme i3bar. Voir [status_command] pour savoir comment afficher i3status dans i3bar.

Quelle que soit l'application que vous utilisez pour afficher la barre d'état, vous voulez vous assurer qu'elle s'enregistre en tant que dock à l'aide du support EWMH. i3 positionnera la fenêtre en haut ou en bas de l'écran, en fonction de l'option définie par l'application. Avec i3bar, vous pouvez configurer sa position, voir [i3bar_position].

Lorsque vous donnez une présentation, vous voulez généralement que le public voie ce que vous voyez sur votre écran, puis passe par une série de diapositives (si la présentation est simple). Pour des présentations plus complexes, vous voudrez peut-être avoir des notes que vous seul pouvez voir sur votre écran, tandis que le public ne peut voir que les diapositives.

Voir https://wiki.archlinux.org/index.php/HiDPI pour plus de détails sur l'activation de la mise à l'échelle dans diverses parties du bureau Linux. i3 lira le DPI souhaité à partir de la propriété Xft.dpi. La propriété est définie par défaut sur 96 PPP, donc pour obtenir une mise à l'échelle de 200%, vous devez définir Xft.dpi: 192 dans ~/.Xresources.

Si vous êtes un utilisateur i3 de longue date et que vous venez de recevoir un nouveau moniteur, vérifiez que :