Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

wall-i3

Wallpaper setter and color palette generator for i3 using pywal.

GitHub stars GitHub forks GitHub issues Last commit

Demo

Demo Gif

Table of Contents

Description

wall-i3 is a shell utility designed to manage desktop backgrounds and color palettes for the i3 window manager. It streamlines the process of updating wallpaper images while integrating with pywal to synchronize system theme colors dynamically across the desktop environment.

Operated via a shell script (wall-i3.sh), the tool serves as a lightweight integration layer between your wallpaper selection, i3wm configuration, and pywal color generation workflows.

This utility is built for Linux users running i3wm who want a straightforward, scriptable method to update their background and maintain a cohesive desktop color scheme without heavy dependencies.

Key Features

  • 🖼️ i3wm Wallpaper Setting — Sets the desktop wallpaper directly within an active i3 window manager session.
  • 🎨 Pywal Color Integration — Integrates with pywal to extract colors from the chosen wallpaper and generate matching themes.
  • 🐚 Lightweight Shell Automation — Runs via a standalone shell script without requiring heavy background daemons or runtime environments.

Use Cases

  • Changing the desktop background in i3wm while automatically generating matching terminal colors via pywal.
  • Hooking wallpaper and color palette updates into i3 startup scripts or keybindings.

Quick Start

# 1. Clone the repository
git clone https://github.com/Skythe7/wall-i3.git

# 2. Edit your wallpaper path
cd wall-i3
nano wall-i3.sh
# See the IMPORTANT comment

# 3. Give permission to execute the script
chmod +x wall-i3.sh
./wall-i3.sh

Contributing

Contributions are welcome! Here's the standard flow:

  1. Fork the repository
  2. Clone your fork: git clone https://github.com/Skythe7/wall-i3.git
  3. Branch: git checkout -b feature/your-feature
  4. Commit: git commit -m 'feat: add some feature'
  5. Push: git push origin feature/your-feature
  6. Open a pull request

Please follow the existing code style and include tests for new behavior where applicable.

Releases

Packages

Contributors

Languages