carousel(6x)

📦
version 6.17 · 10 versions
, in fedora 44

💖 carousel — the 6x manual page 💖

okay bestie, sit down, we're doing XScreenSaver's carousel today, and it's literally one of the prettiest ones. it's a 6x page, so you know what time it is 🎠✨

✨ NAME ✨

carousel — displays multiple images rotating in a circular formation 🎀

🦋 SYNOPSIS 🦋

carousel [--display host:display.screen] [--visual visual] [--window]
[--root] [--window-id number] [--count int] [--zoom | --no-zoom] [--tilt
XY] [--titles | --no-titles] [--font font] [--speed ratio] [--duration
seconds] [--fps] [--debug] [--wireframe]

like. look at her. so many little flags. we love a girl with options 💅

🌸 DESCRIPTION 🌸

So what does it actually DO, you ask? it loads a bunch of random images, and then it displays them flying around in a circular formation. that's the whole vibe. 🎠

And then — because one circle is never enough — the circle changes speed and direction randomly, it tilts on its axis, and the images move in and out. it's giving screensaver but make it a carousel. iconic, no notes. 🌈

⚠️ heads up bestie: this program requires a good video card capable of supporting large textures. she is ✨high maintenance✨ and we respect that. 💅

And if you wanna specify the directory that images are loaded from? run xscreensaver-settings(1) and click on the "Advanced" tab. that's where the magic directory lives. 🗂️✨

🎀 OPTIONS 🎀

one bullet per flag, no skipping, we're thorough in this household 💖

  • --visual visual — which visual to use, bestie. legal values are either the name of a visual class, or the id number (decimal or hex) of a specific visual. pick your fighter. 🎨
  • --window — draw on a newly-created window. this one is the default! 🪟
  • --root — draw on the root window. main character behavior honestly. 👑
  • --window-id number — draw on the specified window. you point, it draws. 🫵
  • --count int — how many images to display. default 7. seven little images. a lucky number, lowkey. 🍀
  • --zoom | --no-zoom — whether the images should move in and out (toward and away from the axis of rotation). default true. so yes, they wiggle. 🦋
  • --tilt XY | --no-tilt — whether the axis of rotation should tilt, and how. -tilt X means that it will tilt toward and away from the viewer. -tilt Y means that it will tilt to the left and right of the screen. -tilt XY (the default) means it will do both. she does it ALL. 💃
  • --titles | --no-titles — whether to display the file names of the images beneath them. default: yes. name a girl, she performs better. 📛
  • --font font-name — the font to use for titles. note that the size of the font affects the clarity of the characters, not their size (it is auto-scaled.) so don't come for me about the size, okay? 😭
  • --duration seconds — every duration seconds, one of the images will be replaced with a new one. default 20 seconds. rotating the roster fr fr. 🔄
  • --speed ratio — speed up or slow down the animation. 0.5 means half as fast as the default; 2.0 means twice as fast. go fast or go slow, both are valid. 🏎️
  • --delay number — per-frame delay, in microseconds. default: 20000 (0.02 seconds.). precision queen. ⏱️
  • --fps — display the current frame rate, CPU load, and polygon count. nerd stats, but make it cute. 📊
  • --debug — prints debugging info to stderr. bathroom break for nerds. 🐛
  • --wireframe — another debug mode. yes bestie, there are two debug modes. slay. 🔺

🧚 ENVIRONMENT 🧚

  • DISPLAY — to get the default host and display number. where am i, who am i. 🪞
  • XENVIRONMENT — to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. the override file, the plot twist. 📜
  • XSCREENSAVER_WINDOW — the window ID to use with --root. 🪟

💜 SEE ALSO 💜

go read these next, bestie, we're building a whole syllabus:

Copyright © 2005 by Jamie Zawinski.

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.

(translation: go off, use it, just leave Jamie's name on it and don't sue if it explodes. 💖)

🌈 AUTHOR 🌈

Jamie Zawinski. 👑

okay that's the whole page, and before you go — this absolutely gorgeous piece of documentation is from X Version 11, version 6.17-1.fc44, dated 13-Oct-2026, and honestly? ate. no crumbs. periodt. 💅🎠✨

📦 where this page comes from