xdesktopwaves is a cellular automata setting the
background of your X Windows desktop under water.
Windows and mouse are like ships on the sea.
Each movement of these ends up in moving water waves.
You can even have rain and/or storm stirring up the water
(-rain 0-10, -storm 0-10).
In shaped mode, which is enabled by default, xdesktopwaves usually works
good together with other desktop background programs like xfishtank,
xpenguins, xsnow and xearth.
They are all under water.
xdesktopwaves has many options.
The most important ones are -quality 0-9
and -colortheme 0-9.
The first one is for adjusting the balance between
display quality and system load.
And the other option is for selecting a set of colors for visualization.
Choose a color theme suitable for your background picture.
There are even options for fine-tuning.
If you are using the KDE window manager, please enable "Allow
programs in desktop window" in the KDE desktop configuration (right-click
on the desktop and choose "Configure Desktop").
Otherwise xdesktopwaves may not be visible.
If you are using Enlightenment 0.16 with "Multiple Desktops"
instead of "Virtual Desktops", xdesktopwaves appears always on the
A solution is -wmbackdrop, but read the comments on that option.
With most other window managers xdesktopwaves should
work without difficulties.
If not, try -root, -wmbackdrop or -window, and/or
If supported by the window manager, you should decide to enable opaque moving
and resizing of windows ("display content in moving windows" or something
like that), instead of displaying just a frame.
This may result in very dynamic wave effects - try to pile up a big wave
by moving a window slowly.
But: unfortunately some window managers seem to be
very CPU-intensive while moving a window opaque.
In that case xdesktopwaves does not perform very smooth.
Starting and stopping
For a first try, open a shell and type xdesktopwaves followed
by desired options.
xdesktopwaves -quality 4 -colortheme 3
Just press CTRL-C for stopping.
Now, if you want to create menu entries in your desktop
environment, window manager or wherever:
For starting, create an entry containing a command like the example above.
And for stopping, create an entry containing this command:
Whenever xdesktopwaves is starting, it automatically tells other
instances of xdesktopwaves to terminate.
So there cannot be more than one instance.
xdesktopwaves every day?
Depending on the quality settings, xdesktopwaves can be very CPU-intensive.
To get along with this, the program goes into an idle mode if
there are no waves on the water or if the output window is
obscured. The cellular automata stops computing in that mode.
Additionally, you can give a lower priority to the xdesktopwaves
process (see -nice).
If you want to have xdesktopwaves automatically started when starting X Windows,
insert the start command in the file $HOME/.xinitrc (see startx(1)).
But dont forget to append & to the command.
This way, xdesktopwaves is started before the window manager (may or may
not work, depending on the type of window manager).
xdesktopwaves is copyrighted (C) 2004 by Oliver Hamann
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA