wallrs

Simple TUI Wallpaper Manager for X11/Wayland.

Table of contents

• Requirements
• Installation
• Features
• Configuration
• Keybindings

Requirements

• chafa
• feh (for X11)
• awww (for Wayland)
• pywal (optional)
• hellwal (optional)
• telegram-palette-gen (optional)

Installation

From crates:

cargo install wallrs

From Source, after cloning the repository:

cargo install --path .

Features

• Change dinamically your wallpaper.
• History of recently used wallpapers.
• Toggle favorite wallpapers to find them easily.
• Mouse support.
• Vim motion.

Configuration

All the configuration happens in a config.toml file.

• wallpaper_dir: the directory root of the wallpapers library.
• vim_motion (true/false).
• mouse_support (true/false).
• list_position ("top"/"bottom"/"left"/"right")
• transition_type (only for awww)

The position and the visibility of the tabs are customizable.

[[tabs]]
name = "Wallpapers"
enabled = true

[[tabs]]
name = "Favorites"
enabled = true

[[tabs]]
name = "History"
enabled = true

The parameter of the wallpapers are customizable.

[commands]
awww = ["--transition-fps", "60"]

Keybindings

The keybindings are configurable in a keybindings.toml file.

• search
• favorite
• multi_select