Configure

Sunpaper takes a few configuration options available by editing the sunpaper.sh file directly:

Basic Configuration

Set your latitude and longitude for your current location. If you aren't sure you can get these numbers from places like latlong.net or even google maps.

Make sure your latitude number ends with N or S
latitude="38.9072N"

and longitude ends with W or E
longitude="77.0369W"

Set the full path to the location of the sunpaper theme folder for the wallpaper you want:
wallpaperPath="$HOME/sunpaper/images/The-Desert"

Set what mode your wallpaper is displayed.
Options include: stretch | center | tile | scale | zoom | fill
wallpaperMode="scale"N or S

Sunpaper writes some cache files to keep track of persistent variables. Set a different location for these or just leave it as the default. cachePath="$HOME/.cache"

Manual Offsets

The timing of wallpaper changes is also configurable with human-readable relative time statements, if you can make sense of the bash--take a look at the get_suntimes() function. By default, most of the day/night is represented with a single wallpaper image, but then there is a flurry of activity within 1.5 hours of both sunrise/sunset.

---

The rest of the configuration settings are for optional display modes.

• Live Weather Mode - show wallpaper based on weather outside
• Moonphase Mode - show wallpaper with correct moon phases for date
• Animation/swww Mode - Animate transitions with swww.
• Darkmode - run external scripts on a day/night trigger
• Pywal mode - get on-the-fly color scheme changes for each wallpaper change.
• Waybar mode - display icon and transition report as tooltip