thumbnailer-service(1)

📦
version 3.1.3 · 6 versions
, in nixpkgs unstable, ubuntu stonking

👑 thumbnailer-service — the lomiri one, bestie

okay so before we even get into it: this is thumbnailer-service(1) from the Linux User's Manual, and it's about to be your new fave little background gremlin. she makes thumbnails. she does it well. periodt. 💅

✨ NAME ✨

thumbnailer-service</p> — the Thumbnailer service. that's it, that's the name, she's iconic and she knows it 🎀

🦋 SYNOPSIS 🦋

thumbnailer-service

yeah. no flags. no args. you just run her and she does her thing. main character energy fr fr ✨

💖 DESCRIPTION 💖

okay so the tea is: thumbnailer-service spins up a DBus service whose whole job is making thumbnail images out of your local media files — we're talking photos, audio, and video, the whole trio 🫶. and if that wasn't enough, she also goes and fetches album cover artwork and artist images for many musicians and bands. she's multi-talented, she contains multitudes, lowkey she's booked and busy.

The original images and the scaled thumbnails get cached on disk, so if you ask for a thumbnail of something she's already grabbed before — doesn't matter if it's the same size or a totally different size — she delivers it as efficiently as possible. no redoing work, no wasted effort, she's not about that life 😌

she's fast and scalable, and here's the part that makes her a legend: she guarantees the integrity of her on-disk data structures even if there's a crash or a power loss. like, rip the plug out of the wall, she does not care, the data is fine. no cap. 🔥

she's activated on demand by DBus (so she's not out here burning resources for no reason), and by default she shuts down after 30 seconds of idle time. she naps. respectfully. 💤

when she's up, she connects to the DBus session bus as com.lomiri.Thumbnailer. The interface for retrieving thumbnails lives at the path /com/lomiri/Thumbnailer, and the administrative interface — which you should go read about in lomiri-thumbnailer-admin(1) — lives at the path /com/lomiri/ThumbnailerAdmin.

bestie note: two different paths, two different jobs. don't mix them up or you will humble yourself 🙈

🎀 CONFIGURATION 🎀

She uses dconf(7) for her configuration, bestie. that's the whole vibe. for all the specifics, go check out thumbnailer-settings(5) — she's got a whole other manual for that. 📖

🌸 ENVIRONMENT 🌸

she reads these environment variables, so listen up:

  • THUMBNAILER_UTIL_DIR — the directory where she should go looking for the vs-thumb executable, which is the lil tool she uses to extract images from streaming media. if this isn't set, she expects that program to just be chilling in /usr/lib/<arch>/thumbnailer. <arch> is a placeholder, don't @ me 💀
  • THUMBNAILER_MAX_IDLE — the service exits once she's been idle for however many milliseconds this variable says. if it's not set, the default value of 30000 is assumed. (that's the 30 seconds from earlier, queen of consistency 👑)
  • THUMBNAILER_UBUNTU_SERVER_URL — this one overrides the URI of the remote image server. if it's not set, the default URI https://dash.ubuntu.com is used. yes that's a real URL, copy it exactly 🌈
  • THUMBNAILER_LOG_LEVEL — overrides the value of the log-level setting. that's it, that's the whole job.
  • XDG_CACHE_HOME — this decides where the on-disk caches live. caches get written to subdirectories of $XDG_CACHE_HOME/lomiri-thumbnailer. If XDG_CACHE_HOME isn't set, then $HOME/.cache/lomiri-thumbnailer is used instead. And if $HOME is also not set? then the home directory gets determined by its setting in /etc/passwd, and home-dir/.cache/lomiri-thumbnailer is used. it's giving fallback queen, she has a plan for every scenario 🧚

💜 SEE ALSO 💜

go read these too, they're all part of the family:

and that's the whole page, bestie!! Version 3.1.3, dated Jul 2026 — go forth, make thumbnails, stay iconic 💖✨🎀

📦 where this page comes from