xdesktopwaves(1)

📦
version 1.4 · 2 versions
, in fedora 43, fedora 44

💧 xdesktopwaves — the xdesktopwaves(1) page, bestie edition 🌊

okay so. picture this: your desktop, but it's under water. that's the whole thing. let's get into it 💖

✨ SYNOPSIS ✨

xdesktopwaves [option]...

🫧 DESCRIPTION 🫧

xdesktopwaves is a cellular automata that sets the background of your X Windows desktop under water. yes, literally under water. your windows and your mouse are like ships on the sea, and every single movement they make ends up as moving water waves. you can even have rain and/or storm stirring up the water — that's -rain 0-10 and -storm 0-10, iykyk 🌧️

in shaped mode, which is enabled by default, xdesktopwaves usually works so good together with other desktop background programs like xfishtank, xpenguins, xsnow and xearth. they're all under water. no cap. 🐟🐧❄️🌍

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, because of course there are.

🪟 Window Managers 🪟

unfortunately 😭 xdesktopwaves does not function on every X11 desktop, because some modern window managers (or compositing managers) do not support classic X11 override-redirect backdrop windows. you will have to try it out. if it does not work, please try it with the -root option, then with the -wmbackdrop option, and finally with -window (but with the last one, xdesktopwaves does not appear in the background). please read the comments on these options more below. it may also be helpful to add -opaque.

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. yes, that's a flex. do it. 🌊👑

🚀 Starting and stopping 🚀

for a first try, open a shell and type xdesktopwaves followed by desired options. example:

xdesktopwaves -quality 4 -colortheme 3

just press CTRL-C for stopping. iconic, simple, done.

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:

xdesktopwaves -end
hint: whenever xdesktopwaves is starting, it automatically tells other instances of xdesktopwaves to terminate. so there cannot be more than one instance. it's giving main character energy, honestly. only one of her at a time 💅

🌅 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 don't 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). fingers crossed bestie 🫶

⚙️ GENERAL OPTIONS ⚙️

  • -h or -help — print a short help and exit. bye 👋
  • -V or -version — print version and exit.
  • -v or -verbose — print some information about what's going on. she's chatty, we love her.
  • -vv or -veryverbose — print much information (for debugging). full transparency mode, literally 💀
  • -d name or -display name — connect to the display named name.
  • -e or -end — exit after terminating a possibly already existing instance of xdesktopwaves. the gentle "you, out" 💅

🪟 WINDOW CREATION OPTIONS 🪟

  • -r or -root — do not create any window, draw the waves to the (virtual) root window. this option implies -stippled if not -opaque.
  • -w or -window — create an ordinary normal window. for some window managers you'll even have to give -opaque.
  • -b or -backdrop (default) — create an override-redirect backdrop window on the (virtual) root window.
  • -wmb or -wmbackdrop — create a backdrop window using the extended window manager hints. this is not supported by every window manager. and if it is, there's still the problem that it may not be possible to activate icons or menus on the desktop background (possibly just at every second scan-line in shaped mode). so, like, manage your expectations 🌸
  • -nxb or -noexitbutton — do not create the (emergency) exit button. with some window managers (or compositing managers), the backdropping fails in a way that the user cannot see or control any window or menu on the whole desktop. unfortunately, the automatic backdrop failure detection is not able to detect all such situation. therefore an exit button is created at top level in the upper-right corner of the desktop. with this option, that button is not created. this only concerns -root, -backdrop, and -wmbackdrop.
lowkey important: that exit button exists for a reason. if you turn it off, you're on your own, bestie 😭
  • -nbf or -nobackdropfail — do not abort if backdropping fails. normally, the program exits automatically when there is nothing in front of the xdesktopwaves window, because then the backdropping has probably failed in lack of support by the window manager. with this option, that exiting does not happen. this only concerns -backdrop and -wmbackdrop.

🫧 TRANSPARENCY OPTIONS 🫧

  • -o or -opaque — have no transparency at all.
  • -t or -stippled — have faked transparency. this lets the desktop background picture shine through. other desktop background programs and desktop icons may not be visible. the window of xdesktopwaves inherits the background from the root window, and the waves are drawn in stippled mode. this option implies -nodoublebuffer.
  • -s or -shaped (default) — have better transparency. everything behind xdesktopwaves shines through ✨. the window of xdesktopwaves is shaped by every second scan-line, using the XShape extension. this option is ignored if -root, otherwise this option implies -doublebuffer.
  • -wmo percent or -wmopacity percent — have best transparency. this is still highly experimental! it sets the window property _NET_WM_WINDOW_OPACITY, which is a hint for the window manager respectively composite manager to render the window with alpha blending. this option is ignored if -root.
⚠️ ok so -wmo is the experimental one. she's gorgeous but she's testing, so don't come for me if she acts up 🙈

🔥 PERFORMANCE OPTIONS 🔥

  • -q number or -quality number (default: 5) — set overall quality of the waves. number can be 0 to 9. the higher the quality, the higher the CPU/network load. this option is a comfortable alternative for -framerate, -simsperframe, -eventsperframe, -resdivision, -cellsize and -maxcolors.
  • -fr rate or -framerate rate — set maximum frame rate in hertz. this option is overridden by -quality.
  • -sf count or -simsperframe count — set number of simulation steps per frame. hereby you can adapt the speed of the waves. this option is overridden by -quality.
  • -ef count or -eventsperframe count — set number of event processings per frame. this can improve the trails of fast moving objects (mouse and windows), but it can even incur a sensible higher CPU load, because of a worse cache utilization. maximum is the number of simulation steps per frame. this option is overridden by -quality.
  • -rd rdx rdy or -resdivision rdx rdy — set overall division of resolution in x and y direction. these values have dramatic influence on the CPU usage on both sides, the client and the server. this option is overridden by -quality.
  • -cs cw ch or -cellsize cw ch — set width and height of the cells of water. these values have dramatic influence on the CPU usage on the client side. the water surface is made of rectangular cells. this is a kind of an image, where each pixel is a cell. for each frame, that image is scaled up to the screen size in two steps. in the first step it is scaled by (cw, ch) with bi-linear interpolation, and in the second step it is scaled by (rdx, rdy) without interpolation. this option is overridden by -quality.
  • -mc count or -maxcolors count — set maximum number of colors for drawing the waves. the higher the color count, the more rectangles may be sent to the X server. count can be 2 to 128. this option is overridden by -quality.
  • -db or -doublebuffer (default) — draw with double buffering. this option is ignored if -stippled.
  • -ndb or -nodoublebuffer — draw without double buffering. this option is ignored if -shaped.
  • -n increment or -nice increment (default: 0) — increment nice value of the xdesktopwaves process. the higher the nice value, the lower the process priority. a typical value for increment is 10.
  • -i or -idle (default) — go idle if there are no waves or if the output window is obscured. this can spare CPU cycles. self-care, honestly 🧚
  • -ni or -noidle — never go idle.
  • -mo number or -maxoptimization number (default: 2) — set maximum optimization by CPU instruction set. if compiled with GCC for x86 (32 or 64-bit), 1 means MMX and 2 means SSE2. 0 means to have no special optimization.

🎨 COLOR OPTIONS 🎨

  • -c number or -colortheme number (default: 0) — select a color theme. number can be 0 to 9. just try them through. this option is a comfortable alternative for -watercolor, -skycolor and -lightcolor. go on, scroll through all ten, it's giving fashion show 🌈
  • -wc color or -watercolor color — set color of water. this option is overridden by -colortheme.
  • -sc color or -skycolor color — set color of sky reflections. this option is overridden by -colortheme.
  • -lc color or -lightcolor color — set color of light reflections. this option is overridden by -colortheme.

and that's only part one, bestie… there's more where that came from 💜

💧 PHYSICS OPTIONS 💧

okay bestie, this is where the water gets its whole personality. 🌊✨

  • -wm or -wavesbymouse (default) — produce waves when the mouse pointer moves. yes, your cursor is literally making ripples. 💅
  • -nwm or -nowavesbymouse — ignore the mouse completely. no cursor drama here. 🙈
  • -ww or -wavesbywindows (default) — produce waves from client windows. the windows are the main characters now. 👑
  • -nww or -nowavesbywindows — ignore client windows. not today, windows. 💀
  • -rn intensity or -rain intensity (default: 0) — simulate raindrops falling on the water. intensity can be 0 (no rain) to 10 (cloudburst). so if you want a whole stormy vibe, turn this up. 🌧️
  • -st intensity or -storm intensity (default: 0) — simulate a storm blowing on the water. intensity can be 0 (no wind) to 10 (strong storm). wind machine: activated. 🍃
  • -vs value or -viscosity value (default: 3) — set viscosity of the fluid. value can be 1 to 5. the higher the viscosity, the shorter the lifetime of waves. thick water = waves that ghost you faster. 😭
  • -si intensity or -skyintensity intensity (default: 5) — set intensity of sky reflections. intensity can be 1 to 10. sky mirror glow-up. ✨
  • -li intensity or -lightintensity intensity (default: 5) — set intensity of light reflections. intensity can be 1 to 10. light bouncing off water? iconic. 🔥
  • -lal degrees or -lightaltitude degrees (default: 30) — set altitude of the source of light. degrees can be 0 to 90. how high up is the light, bestie? 🌞
  • -laz degrees or -lightazimuth degrees (default: -35) — set azimuth of the source of light. degrees can be -360 to 360. spin that light around, periodt. 🌈

🌊 EXAMPLES 🌊

here are the exact little commands, no cap:

xdesktopwaves -quality 6 -colortheme 1 -verbose

Increased quality. Blue color theme. Print information about settings and performance.

xdesktopwaves -q 6 -c 1 -v

Short cut of the previous example.

xdesktopwaves -c 2 -rn 8 -r -o

Dark night with flashy lights. It's raining. Draw to the root window without any transparency.

👀 SEE ALSO 👀

go peek at these too: xfishtank, xpenguins(1), xearth(1), xsnow(1), xlife(1x), xsetroot(1), startx(1).

🌐 HOMEPAGE 🌐

http://xdesktopwaves.sourceforge.net/

👑 AUTHOR 👑

Oliver Hamann (olha@users.sourceforge.net)

xdesktopwaves is copyrighted (C) 2004,2019 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

and that's the whole manual page, bestie 🫶 this one came from xdesktopwaves 1.4, dated 14 July 2019. stay hydrated, stay wavy 💖✨

📦 where this page comes from