WALLCH(1)

📦 version 4.0, in ubuntu jammy, ubuntu noble

💖 WALLCH(1) 💖

okay so bestie, welcome to wallch — aka the Wallpaper Changer — and yes she's from the General Commands Manual, she's an icon, she's been serving desktop backgrounds since forever. sit down, grab a strawberry 🍓, and let's get into it.

✨ SYNOPSIS ✨

wallch [options]

that's it. that's the whole vibe. just wallch plus whatever options your heart desires. 💅

🦋 DECRIPTION 🦋

so wallch is a free and open-source application for managing your desktop background, and she does a lot more than just swap pictures, no cap. she comes with various functions, such as:

  • rotating your hard drive's wallpapers 🔄
  • live earth 🌍
  • wikipedia picture of the day 🖼️
  • wallpaper clocks 🕐
  • live website 🌐

she supports Gnome (with or without Unity integration, she's flexible like that), LXDE and XFCE desktop environments.

and here's the slay part: wallch can work with or without its Graphical User Interface, for extra lightweightness. main character energy fr fr. 👑

🌸 OPTIONS 🌸

okay so quick heads up before you scroll, bestie: please notice that all the options, except from --change, --help, --cache, --fcache, and --version, will be sent to the already running instance of Wallch, if there is one. yes, she talks to herself. she's that girl. 😭
  • --help — shows a menu with the available options. your little cheat sheet, your bestie's bestie. 🫶
  • --change[=DIRECTORY] — picks a random image and sets it as your desktop background from the last used folder. but if a DIRECTORY is specified, then that directory gets recursively searched for images and a random one is picked from there. surprise!! 🎲
  • --start — starts the wallpaper changing process using the last specified folder. let her cook. 🔥
  • --earth — starts the live earth process. the planet, but make it your background. 🌍✨
  • --potd — starts the picture of the day process. today's wikipedia banger, delivered. 📸
  • --clock — starts the wallpaper clocks process. time, but aesthetic. 🕰️
  • --website — starts the live website process. yes, a whole website as your wallpaper. iconic behaviour. 🌐💅
  • --stop — stops any running process, like live earth or picture of the day. she said enough. ✋
  • --quit — closes any instances of the program. bye bestie, love you, text me. 👋💜
  • --next — proceeds to the next image, if available. ⚠️ this works only when the normal wallpaper changing process is running. so like, don't try it while she's napping. 🙈
  • --previous — proceeds to the previous image, if available. ⚠️ also works only when the normal wallpaper changing process is running. same energy, opposite direction. ⏪
  • --pause — pauses the normal wallpaper changing process. she's taking a lil self-care break. 🧖‍♀️
  • --cache DIRECTORY — searches DIRECTORY recursively for supported images and caches them. this allows a much better experience when viewing the images of this DIRECTORY from Wallch, because they load much faster. 🏃‍♀️💨
please note that this argument takes into consideration the cache limit and may delete some cached images of the specified folder if this limit is exceeded. 😳

Wallch by default caches the images while they are being viewed, so this option may only be used if the user does not want to wait for the pictures to load and be cached when viewed for the first time from Wallch. iykyk.

  • --fcache DIRECTORY — same as --cache but without taking into consideration the cache limits. if you open Wallch's Graphical User Interface afterwards, the limits will be taken into consideration and the extra images will be deleted. 😭

Wallch calculates which images are most likely not to be seen according to the last used folder, and it deletes the extra images from the cache, if the limit is exceeded. this option is useful when you simply want to generate thumbnails for all the images in a folder, or you simply don't want to wait for Wallch to calculate and delete the extra images for the time being. lowkey a shortcut, highkey useful. ✨

  • --version — shows the program's version. the "how old are you" of commands. 🎂

💀 BUGS 💀

if you find a bug, please report it at alexsol.developer@gmail.com, leon.vitanos@gmail.com or at launchpad (https://bugs.launchpad.net/wallpaper-changer).

not me asking you to snitch on her, but like... do it, she wants to grow. 🫶🌈

👑 AUTHORS 👑

  • Leon Vitanos (leon.vitanos@gmail.com)
  • Alex Solanos (alexsol.developer@gmail.com)

the mothers of the whole operation, we stan. 💖

okay that's the whole page, bestie! this lil slice of manual history is dated February 2014 and lives in the WALLCH(1) section of the manual. thank you for coming to my ted talk, now go change your wallpaper. 🎀🦋💜

📦 where this page comes from