{"id":13435327,"url":"https://github.com/adi1090x/battery-wallpaper","last_synced_at":"2025-04-06T10:13:51.534Z","repository":{"id":41167070,"uuid":"241396261","full_name":"adi1090x/battery-wallpaper","owner":"adi1090x","description":"Simple bash script to set wallpaper according to battery percentage with charging animations.","archived":false,"fork":false,"pushed_at":"2023-10-17T14:35:10.000Z","size":18225,"stargazers_count":396,"open_issues_count":3,"forks_count":22,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-30T09:06:42.923Z","etag":null,"topics":["adi1090x","arch-linux","archcraft","bash","bash-scripts","battery-information","battery-monitor","battery-status","battery-wallpaper","battery-widget","debian","dynamic-wallpaper","linux","live-wallpaper","ubuntu","unixporn","wallpaper-changer","wallpaper-engine","wallpaper-manager"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adi1090x.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-18T15:27:03.000Z","updated_at":"2025-02-05T20:13:20.000Z","dependencies_parsed_at":"2024-11-09T18:11:53.181Z","dependency_job_id":null,"html_url":"https://github.com/adi1090x/battery-wallpaper","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adi1090x%2Fbattery-wallpaper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adi1090x%2Fbattery-wallpaper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adi1090x%2Fbattery-wallpaper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adi1090x%2Fbattery-wallpaper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adi1090x","download_url":"https://codeload.github.com/adi1090x/battery-wallpaper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247464224,"owners_count":20942970,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adi1090x","arch-linux","archcraft","bash","bash-scripts","battery-information","battery-monitor","battery-status","battery-wallpaper","battery-widget","debian","dynamic-wallpaper","linux","live-wallpaper","ubuntu","unixporn","wallpaper-changer","wallpaper-engine","wallpaper-manager"],"created_at":"2024-07-31T03:00:34.877Z","updated_at":"2025-04-06T10:13:51.516Z","avatar_url":"https://github.com/adi1090x.png","language":"Shell","funding_links":[],"categories":["HarmonyOS","Shell","Packages"],"sub_categories":["Windows Manager","Background setting utilities and generators"],"readme":"\u003c!-- Battery Wallpaper --\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/logo.png\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Maintained%3F-Yes-green?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/adi1090x/battery-wallpaper?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/adi1090x/battery-wallpaper?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/issues/adi1090x/battery-wallpaper?color=violet\u0026style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/forks/adi1090x/battery-wallpaper?color=teal\u0026style=for-the-badge\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003eA simple \u003ccode\u003ebash\u003c/code\u003e script to set an \u003cb\u003eanimated battery\u003c/b\u003e as desktop wallpaper. It shows charging animation and changes according to \u003cb\u003ebattery percentage\u003c/b\u003e.\u003c/p\u003e\n\n![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/leaves.gif) \u003cbr /\u003e\n\n### Overview\n\n+ 21 different types of battery wallpapers/icons.\n+ Shows battery charging animation.\n+ Stop animation when the battery is fully charged.\n+ When not charging, the wallpaper/icon changes according to battery percentage.\n+ Users can add their own icons/styles/wallpapers.\n+ Tested on :\n  - **`Window Managers`** : Works on all window managers (tested on all WMs Archcraft have)\n  - **`Wayland Compositors`** : `sway`, `wayfire`, `river`, `newm`, `hyprland`\n  - **`Desktop Environments`** : `KDE`, `Pantheon`, `Gnome`, `Deepin`, `Cinnamon`, `XFCE`, `LXDE`, `MATE`, `Zorin`, `Budgie`\n\n### Dependencies\n\nInstall Following programs on your system before using `bwall` -\n\n- **`acpi`** : To get battery and charging data\n- **`feh`** : To set wallpapers on WMs\n- **`xrandr`** : Only if you're using XFCE desktop\n\nInstall `acpi`, `feh` and `xrandr` -\n```bash\n# On Archlinux\n$ sudo pacman -Sy acpi feh xorg-xrandr\n\n# On Ubuntu or Debian\n$ sudo apt-get install acpi feh x11-xserver-utils\n```\n\n\u003e For swaywm support users must install [oguri](https://github.com/vilhalmer/oguri). The `oguri` daemon must be started for the script to work. `Oguri` can be installed on Arch linux via [AUR](https://aur.archlinux.org/packages/oguri-git/).\n\n### Installation\n\nFollow the step below to install `bwall` on your system -\n\u003e You can run `test.sh` to test it before installing it on your system.\n\n+ Clone this repository -\n```\n$ git clone https://github.com/adi1090x/battery-wallpaper.git\n```\n\n+ Change to cloned directory and run `install.sh` -\n```\n$ cd battery-wallpaper\n$ chmod +x install.sh\n$ ./install.sh\n```\n\n### Run the program\n\n+ Open the terminal and execute `bwall` -\n```\n$ bwall\n\n┏┓ ┏━┓╺┳╸╺┳╸┏━╸┏━┓╻ ╻   ╻ ╻┏━┓╻  ╻  ┏━┓┏━┓┏━┓┏━╸┏━┓\n┣┻┓┣━┫ ┃  ┃ ┣╸ ┣┳┛┗┳┛   ┃╻┃┣━┫┃  ┃  ┣━┛┣━┫┣━┛┣╸ ┣┳┛\n┗━┛╹ ╹ ╹  ╹ ┗━╸╹┗╸ ╹    ┗┻┛╹ ╹┗━╸┗━╸╹  ╹ ╹╹  ┗━╸╹┗╸\n\nBwall V3.0   : Set desktop wallpaper according to battery percentage.\nDeveloped By : Aditya Shakya (@adi1090x)\n\nUsage : bwall.sh [-h] [-d] delay [-s style]\n\nOptions:\n   -h          Show this help message\n   -d  num     Set charging animation delay (default 0.8s)\n   -s  style   Name of the wallpaper style to apply\n   \nAvailable styles:  bar  bonsai  cartoon  charge  city  city_alt  colours  cup_black  cup_dark  egg\nfaded  frame  industrial  leaves  mechanical  panel  paper  pixel_city  slash  space  sweet  \n\nExamples: \nbwall.sh -s bonsai      Set wallpaper from 'bonsai' style\nbwall.sh -d 1 -s bar    Set wallpaper from 'bar' style with 1sec delay\n```\n\n+ Select the style you like and run -\n```\n$ bwall -s bonsai\n[*] Using style : bonsai\n```\n\n### Previews\n\n\u003cdetails\u003e\u003csummary\u003eClick To View\u003c/summary\u003e\n\n`Bonsai`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/bonsai.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/bonsai.png)|\n\n`Bar`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/bar.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/bar.png)|\n\n`Cartoon`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/cartoon.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/cartoon.png)|\n\n`Charge`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/charge.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/charge.png)|\n\n`Colours`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/colours.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/colours.png)|\n\n`Cup Black`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/cup_black.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/cup_black.png)|\n\n`Cup Dark`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/cup_dark.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/cup_dark.png)|\n\n`Egg`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/egg.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/egg.png)|\n\n`Faded`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/faded.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/faded.png)|\n\n`Frame`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/frame.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/frame.png)|\n\n`Industrial`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/industrial.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/industrial.png)|\n\n`Leaves`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/leaves.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/leaves.png)|\n\n`Mechanical`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/mechanical.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/mechanical.png)|\n\n`Panel`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/panel.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/panel.png)|\n\n`Paper`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/paper.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/paper.png)|\n\n`Slash`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/slash.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/slash.png)|\n\n`Sweet`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/sweet.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/sweet.png)|\n\n`Space`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/space.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/space.png)|\n\n`Pixel City`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/pixel_city.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/pixel_city.png)|\n\n`City`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/city.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/city.png)|\n\n`City Alt`\n|Charging|Full|\n|-|-|\n|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/charging/city_alt.gif)|![gif](https://raw.githubusercontent.com/adi1090x/battery-wallpaper/master/preview/full/city_alt.png)|\n\n\u003c/details\u003e\n\n### Common Issues\n\n1. **Wallpaper not changing** : If your wallpaper is not changing, then open an issue and show me the output of `echo $DESKTOP_SESSION`.\n\n2. **Not working on XFCE** : If this script is not working on xfce, then open the terminal and run `xfconf-query -c xfce4-desktop -m` and change the wallpaper (any) via *xfce4-settings-manager*. \u003cbr /\u003e\nIn the terminal, *xfconf-query* will print lines starting with `set:`, which show which properties have been changed, check `screen` \u0026 `monitor` values and modify the script accordingly.\n```bash\n110   ## For XFCE\n111   if [[ \"$OSTYPE\" == \"linux\"* ]]; then\n112      SCREEN=\"0\"\n113      MONITOR=\"1\"\n114   fi\n\n```\n\n3. **Autostart** : If you want to autostart the script with desktop, you can add it to your WM autostart file \u0026 if it doesn't work for you, you can create a `desktop file` in `$HOME/.config/autostart` dir.\n```bash\n$ cd $HOME/.config/autostart \u0026\u0026 touch bwall.desktop\n\n# Add this to bwall.desktop file\n\n[Desktop Entry]\nName=Battery Wallpaper\nComment=Set desktop background according to battery percentage, with charging animation.\nExec=/usr/bin/bwall -s leaves \u0026\nType=Application\nIcon=wallpaper\nCategories=Accessories;\n```\n\n### Quick FYI\n+ In KDE, `bwall` changes the wallpaper in all the Activities.\n+ You can add ***bwall -s style \u0026*** to your wm autostart file to set it as wallpaper after login.\n+ Have Fun!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadi1090x%2Fbattery-wallpaper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadi1090x%2Fbattery-wallpaper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadi1090x%2Fbattery-wallpaper/lists"}