adapated for Maemo
[shermanaquarium] / sherman-aquarium / XSCREENSAVER
1
2  How to install Sherman's aquarium as a Xscreensaver hack
3 ==========================================================
4
5 First make sure that you have libSDL 1.2.x (www.libsdl.org),
6 xscreensaver (www.jwz.org/xscreensaver) and that you have compiled
7 Sherman's aquarium with Screensaver support.
8 (Notice that some distributions differes the library and the
9 headers. So make sure you have installed the "devel" package
10 of SDL, if you use such a distribution.)
11
12 The rest of the text in this file assumes that you have a 
13 working xscreensaver installation.
14
15 If you have installed the screensaver part of Sherman's aquarium
16 executing "shermans" will demostrate Sherman's aquarium.
17 So try:
18
19 shermans
20
21 (Assuming that you have sherman's aquarium in your path)
22 This will show you sherman's aquarium screensaver in window mode.
23
24 Then go on and edit ~/.xscreensaver (If you don't have such a file,
25 run xscreensaver-demo, it will generate one for you.)
26
27 Find the line:
28 --
29 programs:
30 --
31
32 Insert after that line a new line that says:
33
34 --
35 "Sherman's aquarium" shermans -root \n\
36 --
37
38 Save the changes.
39
40 Now you have to see if the Xscreensaver configuration XML file did
41 end up correctly. Default installation path for GNU programs is
42 /usr/local/, while program that comes with distributions nearly always
43 is installed in /usr/
44 So if you didn't give --prefix=somethingelse to "configure", the 
45 Xscreensaver XML configuration file for Sherman's aquarium(shermans.xml) 
46 did end up in:
47
48 /usr/local/share/control-center/screensavers
49
50 If "shermans.xml" is the only file there, the Xscreensaver is configured
51 with another path. Maybe /usr/share/control-center/screensaver
52 See if you have that directory, and if it contains a lot of .xml files
53 then move the shermans.xml into that directory.
54
55 If you can't find the directory, search for "ant.xml", which is a
56 xscreensaver hack that is installed by default.
57
58 Now it's time to configure Sherman's aquarium and the Xscreensaver.
59 Run xscreensaver-demo. Click on the settings button to configure
60 the apperence of Sherman's aquarium. If the settings window is
61 empty, Xscreensaver can't find "shermans.xml" and if you can't
62 find "Sherman's aquarium" among the Hacks, you might have done
63 something wrong when you edited your ~/.xscreensaver file.
64
65 I think you have to restart the Xscreensaver daemon when you change
66 settings, but I might be wrong on that point.
67
68 If you want to use "Current desktop as background", i.e. let the fish
69 swim over your screen without changing the background, sometimes you
70 have to click in the "Grab Desktop Images" checkbox in the "Advanced"
71 menu in xscreensaver-demo (Just besides Display Modes) or else you
72 might end up with an error message that says something like "Bad Access". 
73
74 The comic strips that are included by default in the Sherman's Lagoon
75 windows screensaver is included in Sherman's aquarium too and
76 can normally be found in:
77
78 /usr/share/pixmaps/shermans/strips/
79
80 (When installed with --prefix=/usr)
81
82 Any questions? Mail them to me, Jonas Aaberg <cja@gmx.net>
83 Please include the word "Shermans" in the subject. Or else your
84 mail might be considered as spam.
85