https://github.com/bst27/dynamic-wallpaper

Receive great wallpapers from online sources. Use cron expressions to define change interval.
https://github.com/bst27/dynamic-wallpaper

100daysofcode cron cron-expression dynamic-wallpaper dynamicwallpaper golang live-wallpaper live-wallpapers unsplash wallpaper wallpaper-changer wallpapers

Last synced: 27 days ago
JSON representation

Receive great wallpapers from online sources. Use cron expressions to define change interval.

• Host: GitHub
• URL: https://github.com/bst27/dynamic-wallpaper
• Owner: bst27
• License: mit
• Created: 2020-08-12T01:21:19.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2025-07-30T08:26:05.000Z (11 months ago)
• Last Synced: 2025-07-30T10:36:29.885Z (11 months ago)
• Topics: 100daysofcode, cron, cron-expression, dynamic-wallpaper, dynamicwallpaper, golang, live-wallpaper, live-wallpapers, unsplash, wallpaper, wallpaper-changer, wallpapers
• Language: Shell
• Homepage:
• Size: 286 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![dynamicWallpaper](https://raw.githubusercontent.com/bst27/dynamic-wallpaper/master/website/banner.png)

# About

This app changes your wallpaper. You can give an URL to define where to get the wallpaper(s) from.

To define when to change your wallpaper you can use a cron expression.

Per default your wallpaper is changed every minute with a random image from [Picsum](https://picsum.photos).

# Usage:

```

./dynamic-wallpaper -url "" -cron ""

```

You can pass a `help` argument to view a help message:

```

  -cron string

        Cron expression which defines when to change wallpaper (default "* * * * *")

  -url string

        URL which returns a wallpaper image (default "https://picsum.photos/1920/1080")

```

# Examples

| URL                             | Info                                          | See                    |

|---------------------------------|-----------------------------------------------|------------------------|

| https://picsum.photos/1920/1080 | Get random image with 1920x1080px from Picsum | https://picsum.photos/ |

| Cron | Info |

|------|------|

| * * * * *  | Change wallpaper at every minute |

| 15 9 * * * | Change wallpaper at 09:15 every day |

| 0 6 * * 1  | Change wallpaper at 06:00 on monday |

To fiddle around with cron expressions you can use [crontab.guru](https://crontab.guru).

# Build

To build executables for multiple platforms you can use the build script at `scripts/build.sh`.