Releasing debian version 0.2.5-1.
[debian/lxlauncher.git] / README
1 LXLauncher is an open source clone of Asus launcher for EeePC.
2 It outperformes the original launcher developed by Xandros.
3
4 Background images used by Asus launcher are non-free and are
5 hence not included in this package.
6
7 Notes for compilation: it requires intltool, GTK+ 2.12 or newer,
8 libstartup-notification and libmenu-cache for compilation.
9
10 Please put the images in /usr/share/lxlauncher/background/.
11 LXLauncher will use those background images if available for any page
12 which has appropriate ID - the image name should be <ID>.jpg, for
13 example Work.jpg, or Internet.jpg, etc.
14
15 Also, if you put the tab icons of Asus launcher under 
16 /usr/share/lxlauncher/icons, they will be used in the tabs.
17 Otherwise, some icons from the gtk+ icon theme will be used instead.
18
19 The LXLauncher has three configuration files to be tuned by users:
20
21 1) ~/.config/lxlauncher/settings.conf which is an init-style file with
22 contents defaults as below:
23
24 [Main]
25 BUTTON_SIZE = 120
26 IMG_SIZE = 48
27
28 2) ~/.config/lxlauncher/gtkrc which is a GTK+ 2 RC file with custom style.
29
30 3) ~/.config/lxlauncher/gtk.css which is a GTK+ 3 CSS file with custom style.
31
32 Also one additional setting can be set in global GTK settings:
33
34 lxlauncher-enable-key
35
36 which is a boolean parameter that allows users if set to true to use
37 up/down/left/right/tab/enter keys to operate the lxlauncher. Default
38 value for it is false.