VARIETY(1)

👑 VARIETY — like, the manual page, bestie 💅

okay so welcome to VARIETY(1), the user-commands girlie of the manual pages. yes she lives in section 1. yes she's iconic. let's go 🦋

---

✨ NAME ✨

variety — Variety Wallpaper Changer 🌸

like. the wallpaper changer. the one. periodt.

---

🎀 SYNOPSIS 🎀

variety [options] [files or urls]

---

💖 DESCRIPTION 💖

so here's the vibe: if you pass local files, Variety just adds them straight to its queue. no drama, no fuss. 🫶

if you pass remote URLs? she'll fetch them into the Fetched folder and then drop them in the queue. so thoughtful of her honestly.

and if you wanna set one specific wallpaper, like right now, no queue nonsense, it's giving:

variety --set /some/local/image.jpg

slay. done. next. 💅

---

⭐ OPTIONS ⭐

okay this is the big one. buckle up bestie, we're going through every single one. no skipping, no cap. 🔥

• --version — shows the program's version number and then dips out. short and sweet. 💜
• -h, --help — shows this help message and exits. the classic "help me bestie" move. 🙈
• --profile=PROFILE — okay this one's meaty, so listen up. This is a profile name or the full path to the configuration folder that Variety should use. If you don't specify anything, it defaults to ~/.config/variety/. But if you give just a name instead of a full path, the profile folder becomes ~/.config/variety-profiles/<name>. ⚠️ Use this only when initially starting Variety — changing the profile path requires a restart, fr fr. The cool part: you can run several instances of Variety at once when you use different profiles, each with its own separate configuration. That's how you'd control, like, several different screens or workspaces under desktop environments like XFCE that allow it. 🖥️ And if you want to pass commands to an already-running instance, you pass the same --profile argument it was started with in your subsequent commands. iykyk.
• -v, --verbose — shows logging messages. and here's the tea: -vv to -vvvvv will profile various parts of Variety with increasing detail. more v's, more info. that's the whole thing. 📈
• -q, --quit — makes the running instance quit. bye bestie 👋
• --get, --get-wallpaper, --current, --show-current — prints the current wallpaper location. Used only when the application is already running. (yes all four of those do the same thing. she contains multitudes. 👑)
• --meta — prints the current wallpaper metadata. Used only when the application is already running.
• --set=SET_WALLPAPER, --set-wallpaper=SET_WALLPAPER — sets the given file as wallpaper. absolute path required, no shortcuts, she's strict about it. 📁
• -n, --next — shows the Next wallpaper. ➡️
• -p, --previous — shows the Previous wallpaper. ⬅️
• --fast-forward — shows the Next wallpaper, but skipping the forward history. zoom zoom. ⏩
• -t, --trash — moves the current wallpaper to Trash. Used only when the application is already running. 🗑️
• -f, --favorite — copies the current wallpaper to Favorites. Used only when the application is already running. 💖
• --move-to-favorites — moves the current wallpaper to Favorites. (copy vs move, know the difference bestie, it matters) Used only when the application is already running.
• --pause — pauses on the current image. ✋
• --resume — resumes regular image changes. back to business. ▶️
• --toggle-pause — toggles the Pause/Resume state. one button, two moods. 🔁
• --toggle-no-effects — toggles "Show Without Effects" for the current image. raw and unfiltered, no cap. ✨
• --quotes-next — shows the Next quote. 💬
• --quotes-previous — shows the Previous quote. 💬
• --quotes-fast-forward — shows the Next quote, skipping the forward history. ⏩
• --quotes-toggle-pause — toggles the Quotes Pause/Resume state. 🔁
• --quotes-save-favorite — saves the current quote to Favorites. quote collecting is a lifestyle. 🫶
• --history — toggles the History display. 📜
• --downloads — toggles the Recent Downloads display. 📥
• --preferences, --show-preferences — shows the Preferences dialog. go tweak ur settings queen. ⚙️
• --selector, --show-selector — shows the manual wallpaper selector — that's the thumbnail bar absolutely stuffed with images from the active image sources. it's giving gallery wall. 🖼️
• --set-option=SET_OPTIONS — sets and applies an option. The option names are the same ones used in Variety's config file ~/.config/variety/variety.conf. you can set multiple options in a single command. example incoming:

'variety --setoption icon Dark --set-option clock_enabled True'

⚠️ USE WITH CAUTION: you're changing the settings file directly, in an unguarded way. no seatbelts. no airbags. just vibes and consequences. 💀 be careful bestie, i'm serious.

---

🌈 SEE ALSO 🌈

okay so like… there's nothing listed here in the original, and i'm not gonna invent one, because inventing stuff = not the move. 🙅‍♀️ so this section is just me waving at you. hi. 👋

---

and that's the whole page bestie!! this manual page is variety 0.9.0, dated May 2026, and it's part of the User Commands of the VARIETY(1) manual. genuinely iconic behavior from a wallpaper changer, tbh. now go set a cute wallpaper. 🎀🦋💜