Skip to content

fast-archer/ellibria

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 

Repository files navigation

🦋 Ellibria - wallpaper fetcher

A lightweight Linux script to fetch and apply wallpapers based on user-defined tags. It supports previewing images in the terminal and works across various desktop environments.

✨ Features

  • Search for wallpapers using tags (e.g., anime, landscape, cat_ears).
  • Display image previews in the terminal (supports Kitty and Ghostty).
  • Prompt for applying wallpapers.
  • Automatically apply wallpapers based on your desktop environment (GNOME, KDE, XFCE, Cinnamon, Budgie, etc.).
  • Save downloaded wallpapers to ~/Pictures/wallpapers.

🚀 Installation

  1. Clone the repository:

    git clone https://github.com/fast-archer/ellibria.git
    cd ellibria
  2. Make the script executable:

    chmod +x ellibria.sh
  3. Run the script:

    ./ellibria.sh

🔧 Dependencies

  • curl: For downloading data.
  • jq: For parsing JSON.
  • kitty or ghostty: For terminal image previews (optional).
  • Desktop environment tools:
    • gsettings: GNOME, Cinnamon, Budgie, Unity.
    • qdbus: KDE Plasma.
    • xfconf-query: XFCE.

Install dependencies on Arch Linux:

sudo pacman -S curl jq kitty

🖼️ Usage

Run the script and follow the prompts:

./ellibria.sh
  1. Enter a tag (e.g., anime ) to search for wallpapers. The script fetches and displays a random wallpaper.

  2. Choose an action: y: apply the wallpaper, n: fetch another wallpaper with the same tag, t: enter a new tag to search for different wallpapers

  3. exit: quit the script.

🌍 Supported Desktop Environments

  • GNOME
  • KDE Plasma
  • XFCE
  • Cinnamon
  • Budgie
  • Unity

📂 Save Location

Wallpapers are saved to:

~/Pictures/wallpapers

⚡ FAQ

Q: Can it be compiled into a binary like kon?
A: Yes, you can compile it using shc or convert it to Python and use PyInstaller. However, the script is lightweight, portable, and works anywhere with Bash and dependencies.

Q: How is it different from kon?
A: Unlike kon, this script isn't tied to Konachan and supports any API. It’s also tailored for multiple desktop environments.

🖤 Author

Crafted with ❤️ for Arch Linux and other distributions, prioritizing simplicity and a beautiful desktop experience.

🌐 Contact

For discussions or suggestions, reach out:

📜 License

MIT License

About

A lightweight Linux script to fetch and apply wallpapers based on user-defined tags. It supports previewing images in the terminal and works across various desktop environments

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages