git.maemo.org Git - shermanaquarium/blob - 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