I3wm: Difference between revisions

Latest revision as of 10:42, 17 March 2025

i3 is a tiling window manager, primarily targeted at advanced users and developers.

Prerequisites

Internet connectivity, unless the packages have been pre-fetched into a local cache.
A non-root user account.
The community repository must be enabled.
Set up eudev.
Install and configure D-Bus. without D-Bus icons and keyboard shortcuts may be missing.
Install appropriate Graphics driver drivers for your hardware. Without graphics drivers, errors are likely to occur.
Install Xorg

Installation

Install i3, i3 status bar and terminal packages i3wm, i3status, xterm

# apk add i3wm i3status xterm

Note: Add the user to input and video groups. The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages.

Install drivers

Ensure you have the required drivers.

# apk search xf86-input*

# apk search xf86-video*

# apk add xf86-video-fbdev xf86-video-vesa

Install fonts

Install fonts. If you start i3 without fonts it will be unusable.

# apk add font-terminus

starting i3

Now you can start i3 manually:

# startx /usr/bin/i3

@@ Line 1: / Line 1: @@
-== Initial setup ==
+{{DISPLAYTITLE:i3wm}}
+[https://i3wm.org/ i3] is a tiling window manager, primarily targeted at advanced users and developers.
-I will assume you are working on a fresh, installation of Alpine standard.
+== Prerequisites ==
-Otherwise see [[Installation|these]] instructions.
+{{:Include:Desktop prerequisites}}
+* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]]
-== Enable Community Repository ==
+== Installation ==
-We need the Community Repository available for access to the i3 packages.
+Install i3,  i3 status bar and terminal packages {{pkg|i3wm|arch=}}, {{pkg|i3status|arch=}}, {{pkg|xterm|arch=}}{{Cmd|# apk add i3wm i3status xterm}}
-Instructions are available on the [[Repositories#Enabling_the_community_repository|Repositories]] page.
-== Install drivers ==
+{{Note|Add the user to '''input''' and '''video''' groups. The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages.}}
+=== Install drivers ===
 Ensure you have the required drivers.
-{{Cmd|# apk search xf86-input*}}
+{{Cmd|# apk search {{pkg|xf86-input*}}}}
-{{Cmd|# apk search xf86-video*}}
+{{Cmd|# apk search {{pkg|xf86-video*}}}}
-=== Example driver installation ===
+{{Cmd|# apk add {{pkg|xf86-video-fbdev|arch=}} {{pkg|xf86-video-vesa|arch=}}}}
-{{Cmd|# apk add xf86-video-intel xf86-input-intel xf86-video-fbdev xf86-video-vesa}}
+=== Install fonts ===
-== Install fonts ==
 Install [[Fonts|fonts]]. If you start i3 without fonts it will be unusable.
-{{Cmd|# apk add font-terminus}}
+{{Cmd|# apk add {{pkg|font-terminus|arch=}}}}
-== Install dbus ==
-Install dbus and set it up.
-{{Cmd|# apk add dbus}}
-{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}
-{{Cmd|# rc-update add dbus}}
-== Install X11 ==
-Install X11 and set it up.
-{{Cmd|# setup-xorg-base}}
-== Install i3 ==
-Install i3, the i3 status bar and a terminal.
-{{Cmd|# apk add i3wm i3status xterm}}
-== Set up a non-root account ==
-Set up a non-root account:
-{{Cmd|# adduser ''new-user''}}
-{{Cmd|# addgroup ''new-user'' input}}
-{{Cmd|# addgroup ''new-user'' video}}
-== Test ==
-Now you can start i3 manually:
-{{Cmd|# startx /usr/bin/i3}}
-{{Note|The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages. More information is available in the [https://i3wm.org/docs/userguide.html i3 user guide].}}
-== Starting i3 on login ==
+== starting i3 ==
-To have i3 start automatically on login, you should set up xinit.
+Now you can start i3 manually: {{Cmd|# startx /usr/bin/i3}}
-There are different ways to do this. The [https://wiki.archlinux.org/title/Xinit ArchWiki]
+== See also ==
-has information on this.
-{{Todo|add section on Xinit}}
+* [[Xorg|Legacy Xorg drivers]]
+* [https://i3wm.org/docs/userguide.html i3 user guide]
+* [https://wiki.archlinux.org/title/Xinit startup i3 automatically]
-[[category: Window Manager]]
+[[category: Desktop]]
+[[category: Window Managers]]