Wallpaper daemon for SanarDE.
  • C 96%
  • Meson 4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-07 17:43:14 +05:00
cli feat(cli): set the wallpaper of a profile 2026-11-07 17:43:14 +05:00
core test(core): cover playlist loading from a path 2026-11-06 16:57:18 +05:00
daemon feat(daemon): follow the profile of nawid over D-Bus 2026-11-07 17:43:14 +05:00
data feat(data): add the profiles key 2026-11-07 17:43:14 +05:00
po feat(cli): set the wallpaper of a profile 2026-11-07 17:43:14 +05:00
protocols build: add wlr-layer-shell protocol description 2026-11-06 16:57:19 +05:00
.gitignore build: ignore the sanitizer build directory 2026-11-07 12:04:12 +05:00
CONTRIBUTING.md docs: list the parts without automated tests 2026-11-07 12:04:13 +05:00
LICENSE feat: add project skeleton and core layout, media and playlist 2026-11-06 16:26:43 +05:00
meson.build build(data): install schema, service file and autostart entry 2026-11-06 16:57:22 +05:00
README.md docs: describe the nawid integration 2026-11-07 17:43:14 +05:00

Sanar Fravashid

Note

Repository Mirrors

  • git.nuros.org (sanarde/fravashid): primary, self-hosted Forgejo instance, accounts restricted to the core team.
  • GitHub (sanarde/fravashid): mirror for external contributors. Issues and Pull Requests opened here are welcome and are reviewed and processed by the core team.

About

Wallpaper daemon for SanarDE that shows images and videos on Wayland and X11 and reads its settings from cfgd.

Dependencies

  • C17 compiler
  • Meson (>= 1.0) and Ninja
  • libdbus-1
  • libcfgd, the client library of cfgd
  • wayland-client, wayland-protocols and wayland-scanner
  • libxcb with the RandR extension
  • libpng and libjpeg
  • libmpv
  • gettext tools (xgettext, msgmerge, msgfmt)

Build

meson setup build
meson compile -C build
meson test -C build
meson install -C build

The install step puts fravashid and fravashi in bin, the cfgd schema in share/cfgd/schemas, the D-Bus service file in share/dbus-1/services and the autostart entry in <sysconfdir>/xdg/autostart.

Running

fravashid selects Wayland when WAYLAND_DISPLAY is set and X11 otherwise. Use fravashid -b wayland or fravashid -b x11 to choose. Only one instance can run per session.

On Wayland the compositor must support wlr-layer-shell. GNOME Shell does not. Each output gets a surface on the background layer. On X11 the image is drawn to the root window and published as _XROOTPMAP_ID, one region per RandR monitor. Videos are played without sound and in a loop.

Settings

Settings are keys of the cfgd schema org.nuros.sanar.fravashi, path /org/nuros/sanar/fravashi/. Changes apply without a restart. Without cfgd the defaults are used.

  • wallpaper: image (PNG, JPEG), video (MP4, MKV, WebM) or a directory of them. Empty shows the background color only.
  • mode: fill, fit, stretch, center or tile. Default fill.
  • color: background color as #rrggbb. Default #000000.
  • interval: seconds between two files of a directory. Zero keeps the first file.
  • shuffle: play the files of a directory in random order.
  • outputs: list of NAME=PATH entries that replace wallpaper on single outputs. Names are the ones of the compositor or of RandR, for example DP-1.
  • profiles: list of PROFILE=PATH entries that replace wallpaper on every output while that nawid profile is applied. An entry of outputs still wins on its output.
cfgd set /org/nuros/sanar/fravashi/mode fit
cfgd set /org/nuros/sanar/fravashi/interval 600

Command line

fravashi get
fravashi next
fravashi prev
fravashi set [-o OUTPUT | -p PROFILE] PATH

get prints the current file of every output. next and prev move every directory one file. set writes wallpaper, the entry of OUTPUT in outputs, or the entry of PROFILE in profiles, through cfgd.

D-Bus interface

Session bus, name org.nuros.sanar.Fravashi, object /org/nuros/sanar/fravashi, interface org.nuros.sanar.Fravashi.

  • Next()
  • Previous()
  • GetCurrent() -> a{ss}: output name to current file, empty when none.
  • Signal Changed(s output, s path).

Seurat

The first output reports its image to Seurat with SetWallpaper(s path) so that system colors follow the wallpaper. A video or a missing file is reported as an empty path. The path is sent again when seuratd appears on the bus later than fravashid.

Nawid

fravashid follows the monitor profile of nawid. It asks GetProfile when org.nuros.sanar.Nawi appears on the session bus and when it starts, and it reads the signal Changed(s profile). The wallpaper of an output is the first of: its entry in outputs, the entry of the applied profile in profiles, wallpaper. Without nawid, or while no profile is applied, only outputs and wallpaper are used. When nawid leaves the bus, the last profile stays.

License

GPL-3.0-only. See LICENSE. The file protocols/wlr-layer-shell-unstable-v1.xml is taken from wlr-protocols and keeps its own license text.