downfall(6)

πŸ“¦ version 6.15, in alpine 3.24, arch rolling, nixpkgs unstable

πŸ’§ downfall(6) β€” like, the whole manual, bestie ✨

okay so you opened the downfall(6) page, welcome, this is the XScreenSaver manual and I'm gonna walk you through it like we're texting at 2am 🫢


🌊 NAME

downfall β€” it's a screen saver. that's it. that's the whole name section. iconic brevity tbh πŸ’…


✨ SYNOPSIS

downfall [--display host:display.screen] [--visual visual] [--window]
[--root] [--delay number] [--speed number] [--scale number] [--fps]

literally just run it with any of those and you're golden ⭐


πŸ¦‹ DESCRIPTION

A close-up view of a grayscale waterfall. no colour, no chaos, just moody gray water up close and personal. it's giving main character cinematography, fr fr πŸŽ€


πŸ’œ OPTIONS

  • --visual visual β€” tells it which visual to use. legal values are either the name of a visual class, or the id number (decimal or hex) of a specific visual. so like, name it or number it, your call 😌
  • --window β€” draw on a newly-created window. this is the default, so if you do nothing, this is what you get πŸͺŸ
  • --root β€” draw on the root window instead. big background energy 🌈
  • --delay number β€” per-frame delay, in microseconds. default: 20000 (that's 0.02 seconds, yes I did the math for you πŸ’–)
  • --speed number β€” animation speed. 2.0 means twice as fast, 0.5 means half as fast. go fast, go slow, go iconic πŸ”₯
  • --scale number β€” resolution. 0.1 - 1.0. default: 1.0. tiny to full-size, no in-between shenanigans 🧚
  • --fps, --no-fps β€” whether to show a frames-per-second display at the bottom of the screen. turn it on if you love numbers, off if you don't πŸ™ˆ

🌸 ENVIRONMENT

  • DISPLAY β€” to get the default host and display number. classic.
  • XENVIRONMENT β€” to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. yes, that's the whole vibe, it's a whole override situation πŸ‘‘
  • XSCREENSAVER_WINDOW β€” the window ID to use with --root. important pairing, don't forget it πŸ’€

πŸ” SEE ALSO

X(1), xscreensaver(1), and https://www.shadertoy.com/view/w3sBWl β€” go look at the shader, it's lowkey the origin story of all this 🌟


Copyright Β© 2025 by Matt Vianueva. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

ngl, that last bit matters: no promises about suitability, and it's "as is" β€” no express or implied warranty, periodt πŸ’…

πŸ’Œ AUTHOR

Matt Vianueva <diatribes@gmail.com>. say hi, he made the waterfall 🫢


and that's the whole page!! X Version 11, 6.15 (30-Mar-2026) β€” that's the source/version and date, bestie, so you know exactly which era of downfall you're living in βœ¨πŸ’–

πŸ“¦ where this page comes from