Wallpaper CLI

A command-line tool for managing wallpapers on Hyprland using SWWW

Overview

• ✅Set Specific Wallpaper - Apply a wallpaper instantly using the CLI.
• ✅Random Wallpaper Selection - Pick a random wallpaper from a user-defined pool.
• ✅Minimal Dependencies - Requires only 'python' and 'swww'.
• ✅Simple & Modular - Clean and maintainable Python codebase.

---

📦 Installation

🔹 Manual Installation

1. Clone the repository:

git clone https://github.com/Akihiro120/wallpaper-cli
cd wallpaper-cli

2. Build and install the package using makepkg:

makepkg -si

---

🖥️ Usage

Once installed, you can run wallpaper-cli directory from the terminal.

Add Picture

wallpaper-cli --add "filepath/to/picture"

Remove Picture

wallpaper-cli --remove index

Set Picture

wallpaper-cli --set index

Display Pictures

wallpaper-cli --display

Prev

wallpaper-cli --prev

Next

wallpaper-cli --next

Toggle Cycle

wallpaper-cli --togglecycle

Enable Cycle Feature

wallpaper-cli --enablecycle

---

🔧 Contributing

Contributions are welcome! Follow these steps:

1. Fork the repository.
2. Create a feature branch:

git checkout -b feature/your-feature-name

3. Make your changes and commit them:

git commit -m "Add feature XYZ"

4. Push the branch to your fork

git push origin feature/your-feature-name

5. Open a pull request

---

📝 License

This project is licensed under the GNU General Public License (GPL). See the LICENSE file for details.

---

📬 Contact

For support, bug reports, or feature requests, please open an issue on GitHub.