worldpieces(6)

📦 version 6.15, in alpine 3.24, arch rolling, nixpkgs unstable

💖 worldpieces(6) — the globe-assembly screen saver, bestie edition 💖

okay so this is a page from the XScreenSaver manual, and it's about a little program called worldpieces that builds the whole entire Earth out of country-shaped puzzle pieces. genuinely iconic.

✨ NAME ✨

worldpieces — globe assembly screen saver. that's it. that's the vibe. 🎀

🌸 SYNOPSIS 🌸

worldpieces [--display host:display.screen] [--visual visual] [--window]
[--root] [--delay number] [--speed ratio] [--no-wander] [--no-rotate]
[--spin ratio] [--speed ratio] [--no-stars] [--underground]
[--fastforward] [--wireframe] [--fps]

🦋 DESCRIPTION 🦋

The Earth fills up with countries one at a time, solving international relations like a jigsaw puzzle. no cap, that's literally what it does — piece by piece, borders locking in, the whole planet assembling itself while you're just sitting there. it's giving world peace but make it a puzzle. 🧩✨

💅 OPTIONS 💅

  • --visual visual — tells it which visual to use. legal values are 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 is the default, so if you don't say anything, this is what you get. 💖
  • --root — draw on the root window instead. main character energy: it's just vibing on your desktop background.
  • --delay number — per-frame delay, in microseconds. default: 20000 (that's 0.02 seconds). yes microseconds, she's precise. ⏱️
  • --speed ratio — animation speed. 2.0 means twice as fast, 0.5 means half as fast. go fast, go slow, you do you. 🔥
  • --wander | --no-wander — whether the planet should wander around the screen. free-range planet rights. 🌈
  • --spin ratio — whether and how fast the planet should rotate around the axis. 2.0 means twice as fast, 0.5 means half as fast. spin her, bestie. 💫
  • --roll | --no-roll — whether the planet should wobble. little wobble. tiny little wobble. adorable. 🍓
  • --stars | --no-stars — whether to display a star field. sparkle or no sparkle, that's the question. ⭐
  • --underground | --no-underground — whether to show the seamy underbelly of the countries. yes, the seamy underbelly. that's the actual phrase. 😭
  • --fastforward | --no-fastforward — if you are impatient waiting for the countries to fill in, this will initially skip ahead a bit. impatient girlies rise 💀
  • --wireframe | --no-wireframe — render in wireframe instead of solid. skeletal chic. ✨
  • --image file — the image to use for the Earth's surface. your world, your rules. 🌍
  • --fps | --no-fps — whether to show a frames-per-second display at the bottom of the screen. numbers go brrr. 📊

🧚 ENVIRONMENT 🧚

  • DISPLAY — to get the default host and display number.
  • XENVIRONMENT — to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.
  • XSCREENSAVER_WINDOW — the window ID to use with --root.

iykyk, these are the little environment gremlins doing background work. 🙈

👑 SEE ALSO 👑

Copyright © 2026 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.

fr fr read that warranty line again — "as is", no promises, absolutely zero. 💀

🌟 AUTHOR 🌟

Jamie Zawinski. legend behavior only. 🫶

and that's the whole page, bestie!! sign-off time: this beauty comes to you from X Version 11, version 6.15 (30-Mar-2026) — keep it cute, keep it exact, and go assemble a planet 💅🌍💖

📦 where this page comes from