Skip to content
Wallpaper Server Wallpaper Server Docs

Web Gallery

Wallpaper Server serves a browser gallery from its root URL. It is backed by the same index and filters as the API, so anything you can do through the API is reflected in the gallery.

Section titled “Opening the gallery”
http://localhost:8519/

The settings page lives at /settings.

Section titled “What the gallery does”
  • Browse your indexed wallpapers as a grid of thumbnails.
  • Filter by the same properties as the API — brightness, orientation, aspect ratio, dominant colour and format — to narrow the grid.
  • Infinite scrolling: more wallpapers load as you scroll, using the same pagination as GET /api/wallpapers.
  • Lazy loading: thumbnails load as they come into view, so large libraries stay responsive.
  • Open or download a wallpaper at full resolution.
  • Upload new images (see Uploading and managing).
  • Delete a wallpaper.

The gallery uses a dark interface consistent with the rest of the project.

Section titled “Filtering in the gallery”

Selecting filters updates the grid to show only matching wallpapers, mirroring the filter parameters. Clearing a filter (or setting it back to any) widens the results again.

Empty and stale states

Section titled “Empty and stale states”
  • If no wallpapers match the current filters, the grid is empty — loosen the filters to see results.
  • The gallery reflects the server’s current index. If you add files directly to a wallpaper folder on disk, rescan with POST /api/refresh (or restart the server) so they appear.
Section titled “Related”