XSTARFISH(1)

✨ XSTARFISH ✨

okay bestie, so xstarfish is a tiled root window wallpaper generator and it lives in section 1 of the General Commands Manual. it makes your desktop cute. that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

xstarfish [ options ]

🦋 DESCRIPTION 🦋

so here's the tea: XStarfish generates colourful, tiled images by taking random numbers and shoving them through mathematical functions, and then it draws the result on the background of your desktop. 🎨✨

and the way it does NOT use source image files?? iconic. genuinely. because of that it can generate its images nearly forever without ever running out of material. infinite content machine, no cap. 👑

💖 OPTIONS 💖

• -h, --help, --usage — prints the message you're reading right now. hi. you found it. 🫶
• -v, --version — shows the current version of the program.
• -d, --daemon INTERVAL [UNITS] — forks off into the background, bestie. XStarfish will generate a pattern, sleep for INTERVAL UNITS, and then repeat, forever, like a lil wallpaper goblin. 🧚 valid units are: seconds, minutes, hours, days, weeks. Seconds are the default interval.
• -p, --pidfile — creates a $HOME/.xstarfish* file containing the pid of the daemon, but only if xstarfish is forking into the background.0 📝
• --display DISPLAY — name of the target display.
• -g, --geometry W[xH] — the size of the image you want. if you omit the height, a square pattern WxW gets generated. squares only, we love a square. 🔲
• -o, --outfile FILE — specify an output file. if you use this option, xstarfish will write a png file instead of setting the X11 desktop. so it's either ✨art✨ or ✨desktop✨, not both.
• -z, --zoom X[xY] — zoom factor of the image. if you omit the y-scale, a uniform zoom of XxX gets applied.
• -s, --size SIZE — an approximate size, but in English. valid size arguments are small, medium, large, full, and random. Full size creates patterns the exact size of your display's default monitor. Small, medium, and large are randomly sizes at appropriate fractions of the default monitor size. Random can be any size from 64x64 up to the whole monitor. and heads up: size always overrides geometry. periodt. 💅
• -r, --random SEED — seed for the rand() call. this one is for debugging purposes.

📌 NOTES 📌

the default size is 256x256. remember it. live by it. 🌈

👑 AUTHOR 👑

Mars Saxman <mars@redplanetsw.com>

and that's the whole page, bestie 🎀 it came straight out of the General Commands Manual (section 1, the XSTARFISH(1) one, iykyk) — no version or date info on this one, just the classic manual name floating at the top and bottom like a lil signature. slay, go make some wallpapers. 🦋💜