(no commit message)
[wikirepo] / eeepc / index.mdwn
1 ## Tweaking Linux on the EEEPC
2
3 The [EeePC][EEEPC_asus] is possibly the first of a new breed of solid state
4 laptops.  The default install has some silly "easy" interface with bits of
5 [KDE][kde], but following the [instructions][kde_install_instructions] on the
6 [eeeuser forums][eee_forums] you can expose a full KDE desktop.  I don't like
7 KDE.  What follows is a selection of notes on customising this little linux box
8 so it's just like all your others!  There are a couple of addons asus provide
9 to show hotkey actions, and to bind to the power button, so I'll cover getting
10 those working too.
11
12 [EEEPC_asus]: http://eeepc.asus.com
13 [kde]: http://kde.org
14 [kde_install_instructions]: http://wiki.eeeuser.com/howto:getkde
15 [eee_forums]: http://forums.eeeuser.org
16
17 ### Getting More Programs
18
19 As the eeepc runs [debian][debian], or at least [xandros][xandros], installing
20 new software is pretty simple.  Add some extra repositories to
21 `/etc/apt/sources.list`, `apt-get update` and you're off.  I've added one from the
22 default xandros distribution -- see below for my sources.list.
23         
24         $ cat /etc/apt/sources.list
25         deb http://update.eeepc.asus.com/p701 p701 main
26         deb http://update.eeepc.asus.com/p701/en p701 main
27         deb http://xnv4.xandros.com/xs2.0/upkg-srv2 etch main contrib non-free
28
29 As the eeepc's running a custom xandros version it's probably best not to
30 upgrade any of the packages without configuring apt's pinning policy.
31
32 [debian]: http://debian.org
33 [xandros]: http://www.xandros.com
34
35 ### Getting Out of "Easy Mode"
36
37 By default the eeepc runs in an "Easy Mode" with lots of pointy clicky bits to
38 get in the way.  Ctrl-Alt-T will get you a terminal though, and from there you
39 almost have a real computer.  If, like me, you never want to see easy mode
40 again then you'll be pleased to hear the version of xinit on the eeepc
41 honours the `~/.xinitrc`.  According to the [forums][setting_up_easy_mode],
42 there are a few details you need to everything set up just so:
43         
44         $ cat ~/.xinitrc
45         #Needed to get automount working
46         xhost + si:localuser:root
47         sudo rm /tmp/nologin
48
49         #Needed to get the network working
50         sudo /opt/xandros/bin/start_netserv &
51
52 But after that everything works just as expected (get my
53 [[.xinitrc|eeepc/xinitrc]]).  Incidentally, my
54 [[sawfish_theme|projects/sawfish-simple]] with it's single pixel borders is very
55 well suited to such a small screen.
56
57 [setting_up_easy_mode]: http://wiki.eeeuser.com/howto:getkde
58
59 ### Asus Extras
60
61 When you're running in easy mode changing brightness, volume, toggling wifi
62 etc. brings up a little display.  Running in full desktop mode, these
63 notifications disappear, starting `/usr/local/bin/asusosd` from your xinitrc
64 will get them back.
65
66 Another difference you might notice in full desktop mode is the lack of a
67 dialogue when you press the power button.  If you'd like it back then add
68 something along these lines to `/etc/acpi/powerbtn.sh`:
69
70         if [ ! -f /home/user/.doingLogin ]
71         then
72                 DISPLAY=:0 su -c /opt/xandros/bin/shutdown_dialog user &
73         fi
74
75 Lastly, the default battery monitor applet is `/usr/bin/powermonitor`.
76
77 ### Using Network Manager
78  * Install `dbus`
79  * Install `network-manager`, `network-manager-gnome`, `gnome-keyring`
80    * force overwrite of libvolume with `dpkg -i --force-overwrite /var/cache/apt...`
81  * Add [[`/etc/hal/fdi/policy/10-networking-ath0.fdi`|eeepc/10-networking-ath0.fdi]]
82  * Simplify [[`/etc/network/interfaces/`|eeepc/interfaces]]
83  * Start network manager and dbus: `/etc/init.d/dbus start`
84  * Start the keyring daemon, sourcing it's output: `. $(gnome-keyring-daemon)`
85  * Start the network manager applet: `nm-applet &`
86
87 ### Living on an SD Card
88  * Automount /home
89  * Overloaded files
90
91 ### Bootloader Tweaks
92  * Boot into single user mode
93          * press f9
94          * tweak grub XANDROSBOOTDEBUG=y
95          * remove `quiet`
96          * add `nosplash`
97  * mount /mnt-system
98  * edit /boot/grub/menu.lst
99  * umount /mnt-system
100  * reboot