zeroctl is a custom CLI tool designed to manage various tasks such as changing wallpapers, fetching weather data, and more for Hyprland. It includes a daemon mode to run scheduled tasks and listen for commands.
- Wallpaper Management: Randomize and set wallpapers.
- Weather Data: Fetch and cache weather data from OpenWeather API.
- Task Scheduling: Schedule and run periodic tasks.
- Task Toggling: Enable or disable specific tasks.
- System Stats: Display system statistics and uptime.
Before building zeroctl, ensure you have the following dependencies installed on Arch Linux:
sudo pacman -S go git swww
yay -S python-pywal16-
Clone the repository:
git clone https://github.com/Z3R0zz/zeroctl.git cd zeroctl -
Copy the example environment file and configure it:
cp .env.example .env # Edit .env to set your environment variables -
Build and install
zeroctl:./build.sh
-
Add the following lines to your hyprland.conf:
exec-once = zeroctl daemon | tee -a /var/log/zeroctl.log exec-once = zeroctl wallpaper | tee -a /var/log/zeroctl.log # Optional
To start the zeroctl daemon, run:
zeroctl daemon-
wallpaper: Randomize wallpaper
zeroctl wallpaper
-
weather: Get the current weather
zeroctl weather
-
stats: Get stats about zeroctl and its usage
zeroctl stats
-
uptime: Display how long the zeroctl daemon has been running
zeroctl uptime
-
toggle: Enable or disable a task
zeroctl toggle <task_name>
WALLPAPERS_DIR: Directory containing wallpapers.AFTER_WALLPAPER_COMMANDS: Commands to run after setting the wallpaper.OPENWEATHER_API_KEY: API key for OpenWeather.OPENWEATHER_CITY_ID: City ID for OpenWeather.OPENWEATHER_UNITS: Units for weather data (e.g., metric).
This project is licensed under the MIT License. Refer to the LICENSE file for more information.