Expand description
Platform layer: finding the monitors and setting the desktop wallpaper.
The OS wallpaper APIs only set static images (PLAN.md section 2). A
WallpaperHost wraps one OS’s API: list the monitors with stable ids and
physical sizes, read and set each monitor’s wallpaper. detect picks the
host for the running system. StillStore writes each still under a new
file name, because some systems don’t reload an unchanged path.
Windows is implemented (IDesktopWallpaper, per monitor); other systems
return PlatformError::Unsupported until their hosts land.
Structs§
- Capabilities
- What a host can do.
- Monitor
- One monitor, in physical pixels.
- Snapshot
- The wallpaper as it was before Clairlune first set one, so it can be put back: each monitor’s image (or none) and the system’s fit mode.
- Still
Store
Enums§
Traits§
- Wallpaper
Host - One system’s wallpaper API.
Functions§
- app_
config_ dir - Clairlune’s configuration directory:
<config>/clairlune. - app_
data_ dir - Clairlune’s data directory (stills, archive, logs):
<local data>/clairlune. - config_
dir - The per-user configuration directory: Roaming AppData on Windows,
~/Library/Application Supporton macOS,$XDG_CONFIG_HOME(or~/.config) elsewhere. - detect
- The host for the running system.
- init_
dpi_ awareness - Makes the process aware of each monitor’s DPI so sizes come back in physical pixels. Call once, before any window or monitor query. A no-op where it does not apply.
- local_
data_ dir - The per-user local data directory: Local AppData on Windows,
~/Library/Application Supporton macOS,$XDG_DATA_HOME(or~/.local/share) elsewhere. - pictures_
dir - The user’s Pictures folder (exports go to
Pictures/Clairlune). - set_
start_ at_ login - Registers or removes
exeas a login item (per user, no admin rights). - start_
at_ login - Whether
exeis registered to start at login;Nonewhere this build can’t manage login items yet. - system_
prefers_ dark - Whether the system asks apps for a dark appearance, when that is known.