Wallpaper packs

Singularity shows wallpapers from providers. The built-in provider has the ID singularity; plugins can register additional providers. In the interface, choose a Theme pack and a Wallpaper pack. Online provider plugins are available through Plugins; OCS and Bing are opt-in and disabled by default.

The .collection file

A local wallpaper pack is described by a .collection file: a GLib KeyFile with a [Collection] group.

[Collection]
Id=your-pack-id
Name=Your Pack's Display Name
Artist=Your Name
Dir=/absolute/path/to/your/images
Type=static

Key	Required	Meaning
Id	no	Stable identifier; defaults to the filename without .collection.
Name	no	Display name; defaults to Id.
Artist	no	Artist attribution.
Dir	yes	Absolute path to the image directory. Files without it are skipped.
Type	no	Pack type; defaults to static.

How the desktop finds it

The shell checks these roots in order:

1. <system data dir>/singularity/wallpaper-collections for each XDG system data directory.
2. <user data dir>/singularity/wallpaper-collections.

When only the default roots are configured, the shell can also use its built-in fallback at <data dir>/backgrounds/singularity.