Skip to content

🗃️ Change your wallpaper in Terminal. Wallhaven, Unsplash, and others!

License

Notifications You must be signed in to change notification settings

UltiRequiem/wallger

Repository files navigation

Wallger: The Wallpaper Changer

CodeQL CI Code Style PyPi Version Repo Size License: MIT Lines of Code

output.mp4

Install

From PyPI

pip install wallger

From GitHub

pip install git+https:/github.com/UltiRequiem/wallger

You may need to install this with administrative permissions, depending on your configuration.

Example Config

~/.config/wallger/config.json:

{
  "resolution": [1600, 900],
  "provider": "wallhaven",
  "path": "/home/zero/disk/sabare/wallger",
  "topic": "anime",
  "tool": "feh",
  "nsfw": false
}
  • Resolution: The resolution of you monitor

    The expected value is a tuple of two integers, eg. [2800, 1900]

  • Provider: The wallpapers provider site

    Currently just "Wallhaven" or "Unsplash"

  • Path: Where to save the images

So you can see your previous wallpapers later

  • Topic: The topic of your wallpaper

Not all providers support this, eg. "Math", "Mirai Nikki", "JavaScript"

  • Tool: The tool to change the Wallpaper

Accepts one of these 👉 ["feh", "gnome", "mate", "kde"]

  • NSFW: Not safe for work

There are not default values, config is required!

Alternatives

  • @neosaile/wpupd: Very similar to this, written in Node.js, by me and my father 😆

License

Wallger is licensed under the MIT License.