https://github.com/cycneuramus/swaywall

An intelligent wallpaper switcher for Sway
https://github.com/cycneuramus/swaywall

python sway swaywm wallpaper wallpaper-changer wallpaper-rotator

Last synced: 3 months ago
JSON representation

An intelligent wallpaper switcher for Sway

• Host: GitHub
• URL: https://github.com/cycneuramus/swaywall
• Owner: cycneuramus
• License: gpl-3.0
• Created: 2023-03-23T09:33:41.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2025-06-17T11:20:46.000Z (4 months ago)
• Last Synced: 2025-06-17T11:48:44.272Z (4 months ago)
• Topics: python, sway, swaywm, wallpaper, wallpaper-changer, wallpaper-rotator
• Language: Python
• Homepage:
• Size: 33.2 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
## Swaywall

An intelligent wallpaper switcher for `swaywm`.

- Sets a random wallpaper from a given directory

- Remembers previous selections:

  - Never repeats a wallpaper until the entire catalogue has been cycled through

  - Can restore the latest selection (useful on `swaywm` start)

## Installation

`swaywall` is packaged on [PyPi](https://pypi.org/project/swaywall) and can be installed using, for example, [`pipx`](https://pipx.pypa.io/stable/):

- `pipx install swaywall`

## Usage

```

usage: swaywall [-h] [-r] [-m {swaymsg,swww}] [-e EXT [EXT ...]] dir

Intelligent wallpaper switcher for swaywm

positional arguments:

  dir                   path to wallpaper directory

options:

  -h, --help            show this help message and exit

  -r, --restore         restore latest wallpaper

  -m, --method {swaymsg,swww}

                        wallpaper setting method

  -e, --extensions EXT [EXT ...]

                        image file extensions to look for (default: png jpg jpeg)

```