https://github.com/maskedsyntax/canvaz
A modern wallpaper companion for Linux desktops
https://github.com/maskedsyntax/canvaz
cpp17 gui qt6 wallpapers x11
Last synced: 4 months ago
JSON representation
A modern wallpaper companion for Linux desktops
- Host: GitHub
- URL: https://github.com/maskedsyntax/canvaz
- Owner: maskedsyntax
- License: mit
- Created: 2024-11-21T06:28:30.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2026-02-11T10:56:18.000Z (4 months ago)
- Last Synced: 2026-02-11T19:02:55.603Z (4 months ago)
- Topics: cpp17, gui, qt6, wallpapers, x11
- Language: C++
- Homepage:
- Size: 233 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Canvaz
A modern wallpaper companion for Linux desktops
---
## Overview
**Canvaz** is a modern, lightweight wallpaper manager built with C++ and Qt.
Inspired by `nitrogen`, it provides a clean, dark-themed interface to manage your desktop backgrounds efficiently.
## Features
- **Multi-Monitor Support**: Independently set wallpapers for Screen 1, Screen 2, or both.
- **Scaling Options**: Automatic, Scaled, Centered, Tiled, Zoomed, Zoomed Fill.
- **Color Background**: Option to set a solid color background.
- **Library Management**: Add multiple directory paths to scan for wallpapers.
- **High Performance**: Asynchronous image scanning and thumbnail generation for instant startup times.
- **Persistence**: Restore your wallpaper settings across sessions using the `--restore` flag.
- **Online Fetching**: Download random wallpapers from the web.
- **Native Backend**:
- **GNOME/Unity/Cinnamon**: Seamless integration via `gsettings`.
- **X11 (i3, bspwm, etc.)**: **Native implementation** using X11 libraries (no external dependencies like `feh` or `nitrogen` required).
## Installation
### Pre-built Packages
You can download the latest packages from the [Releases](https://github.com/maskedsyntax/canvaz/releases) page.
#### Debian/Ubuntu
```bash
sudo apt install ./canvaz-0.2.1-Linux.deb
```
#### Fedora/RHEL
```bash
sudo dnf install ./canvaz-0.2.1-1.x86_64.rpm
```
### Arch Linux
A `PKGBUILD` is available in the releases. To build and install:
```bash
mkdir canvaz-pkg && cd canvaz-pkg
wget https://github.com/maskedsyntax/canvaz/releases/download/v0.2.1/PKGBUILD
makepkg -si
```
## Usage
### Launching the GUI
```bash
canvaz
```
### Restoring Wallpaper (Session Startup)
To automatically restore your wallpaper when you log in (e.g., in your `.xinitrc` or WM config), run:
```bash
canvaz --restore
```
## Build & Install
### Requirements
- Qt 6 (Widgets, Gui, Core, Network)
- CMake
- A C++17 compiler
- X11 development libraries (`libx11-dev`)
### Building
```bash
mkdir build
cd build
cmake ..
make
```
### Running
```bash
./build/canvaz
```
## License
MIT License.