]> git.sur5r.net Git - i3/i3/blob - website/docs/building_ubuntu_9.04.html
Add imprint to the website for compliance with german law.
[i3/i3] / website / docs / building_ubuntu_9.04.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
4 <head>
5 <title>i3 - an improved dynamic tiling window manager</title>
6 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7 <style type="text/css">
8 body {
9         text-align: justify;
10         max-width: 800px;
11 }
12
13 li {
14         margin-bottom: 10px;
15 }
16 </style>
17 </head>
18 <body>
19
20 <h1>Howto build i3 on Ubuntu 9.04 for the amd64 architecture</h1>
21
22 <p>
23   Due to Ubuntu 9.04’s lack of recent libxcb* packages, we cannot simply provide a debian
24   package. The following howto will explain how to build one for yourself after downloading
25   the necessary libxcb* packages from Debian.
26 </p>
27
28 <p>
29   Clone the i3 repository
30 </p>
31
32 <pre>
33 $ git clone http://code.stapelberg.de/git/i3
34 </pre>
35
36 <p>
37   The Ubuntu repositories do not contain the required versions of several packages. Hence we need
38   to get them from Debian. Create a new directory for the .debs
39 </p>
40
41 <pre>
42 $ mkdir deb &amp;&amp; cd deb
43 </pre>
44
45 <p>
46   …and download the files
47 </p>
48
49 <pre>
50 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-wm0-dev_0.3.3-2+b1_amd64.deb"
51 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-aux0-dev_0.3.3-2+b1_amd64.deb"
52 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-wm0_0.3.3-2+b1_amd64.deb"
53 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-atom1-dev_0.3.3-2+b1_amd64.deb"
54 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-event1-dev_0.3.3-2+b1_amd64.deb"
55 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-property1-dev_0.3.3-2+b1_amd64.deb"
56 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-icccm1-dev_0.3.3-2+b1_amd64.deb"
57 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-wm0_0.3.3-2+b1_amd64.deb"
58 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-atom1_0.3.3-2+b1_amd64.deb"
59 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-icccm1_0.3.3-2+b1_amd64.deb"
60 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-property1_0.3.3-2+b1_amd64.deb"
61 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-event1_0.3.3-2+b1_amd64.deb"
62 $ wget "http://ftp.de.debian.org/debian/pool/main/x/xcb-util/libxcb-aux0_0.3.3-2+b1_amd64.deb"
63 </pre>
64
65 <p>
66   We install these:
67 </p>
68
69 <pre>
70 $ sudo dpkg -i *.deb
71 </pre>
72
73 <p>
74   then change into the i3 directory and build the package:
75 </p>
76
77 <pre>
78 $ cd ../i3
79 $ dpkg-buildpackage
80 </pre>
81
82 <p>
83   and install it
84 </p>
85
86 <pre>
87 $ sudo dpkg -i ../i3_1.0-1_amd64.deb
88 </pre>
89
90 <p>
91   What remains is to configure i3. Create the default directory for i3’s config and copy the default config to it
92 </p>
93
94 <pre>
95 $ mkdir ~/.i3
96 $ cp /etc/i3/config ~/.i3/config
97 </pre>
98
99 <p>
100 Lastly, we need to set up i3 as default window manager. Create a new file ~/.xinitrc
101 </p>
102
103 <pre>
104 $ vim ~/.xinitrc
105 </pre>
106
107 <p>
108   and enter the following lines:
109 </p>
110
111 <pre>
112 #!/bin/sh
113 xsetroot -solid black 
114 exec /usr/bin/i3
115 </pre>
116
117 <p>
118   Close vim and create a link to ~/.xinitrc and link it to ~/.Xsession:
119 </p>
120
121 <pre>
122 $ ln -s ~/.xinitrc ~/.Xsession
123 </pre>
124
125 <p>
126   You are done. When you are in the login screen, select "Sessions", and switch to "Default" or "Xsession" to start i3.
127 </p>