{"id":28265600,"url":"https://github.com/simonquasar/batbar","last_synced_at":"2026-04-12T02:35:46.672Z","repository":{"id":293805713,"uuid":"984974542","full_name":"simonquasar/BatBar","owner":"simonquasar","description":"A minimal battery indicator that lives on the edge of your screen.","archived":false,"fork":false,"pushed_at":"2025-05-24T15:49:44.000Z","size":59895,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-26T19:54:24.657Z","etag":null,"topics":["battery","battery-level","battery-monitor","battery-percentage","battery-status","linux","linux-desktop","macos-widget","widget","windows","windows-desktop"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simonquasar.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,"zenodo":null}},"created_at":"2025-05-16T20:45:52.000Z","updated_at":"2025-05-24T15:49:47.000Z","dependencies_parsed_at":"2025-05-17T09:25:19.067Z","dependency_job_id":"ef964e67-f3d4-43e8-a7a2-a95b354b5d21","html_url":"https://github.com/simonquasar/BatBar","commit_stats":null,"previous_names":["simonquasar/batbar"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/simonquasar/BatBar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonquasar%2FBatBar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonquasar%2FBatBar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonquasar%2FBatBar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonquasar%2FBatBar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simonquasar","download_url":"https://codeload.github.com/simonquasar/BatBar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonquasar%2FBatBar/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260653143,"owners_count":23042639,"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":["battery","battery-level","battery-monitor","battery-percentage","battery-status","linux","linux-desktop","macos-widget","widget","windows","windows-desktop"],"created_at":"2025-05-20T12:17:04.223Z","updated_at":"2025-10-23T22:02:12.947Z","avatar_url":"https://github.com/simonquasar.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BatBar | 1-px battery bar \n\n---\n\n**BatBar** is the one pixel wide battery bar. An ultra-minimalist status indicator for Windows, Linux and macOS.\n\nIt consists of **a single-pixel line** that shows your battery level.\n\n[![Download BatBar](https://img.shields.io/badge/BatBar-Download%20here!-ff2850?style=flat-square)](https://github.com/simonquasar/BatBar/releases/latest)\n\n[![GitHub repo](https://img.shields.io/badge/GitHub-BatBar-white?logo=github\u0026color=ffcc00\u0026style=flat-square)](https://github.com/simonquasar/BatBar)\n[![GitHub Release](https://img.shields.io/github/v/release/simonquasar/BatBar?display_name=release\u0026color=ffcc00\u0026style=flat-square)](https://github.com/simonquasar/BatBar/releases/latest)\n\n![Static Badge](https://img.shields.io/badge/11%20%2F%2010-%20?logo=quarto\u0026logoColor=lightblue\u0026label=WINDOWS\u0026color=318ce7\u0026style=flat-square)\n![Static Badge](https://img.shields.io/badge/Ubuntu%2FDebian%2FArch-%20?logo=linux\u0026logoColor=E95420\u0026label=LINUX\u0026color=E95420\u0026style=flat-square)\n![Static Badge](https://img.shields.io/badge/compatible-%20?logo=apple\u0026label=MAC%20OS\u0026color=ff8b9b\u0026style=flat-square)\n\n![Static Badge](https://img.shields.io/badge/Windows-%20?logo=phpstorm\u0026logoColor=1292EE\u0026label=PowerShell\u0026color=1292EE\u0026style=flat-square)\n![Static Badge](https://img.shields.io/badge/Unix%2FmacOS-%20?logo=python\u0026logoColor=green\u0026label=Python\u0026color=84A454\u0026style=flat-square)\n\n\n## Key Features\n\n---\n\n**\u003cp align=\"center\"\u003eAlways visible. Never distracting.\u003c/p\u003e**\n- **Instant visual feedback**: the height of the bar reflects the battery level\n- **Intuitive color coding**: simple red, orange, yellow and green + blue for charging\n- **Always on top**: persistent visibility, zero distraction\n- **Adjustable width**: scroll to resize\n\n\n**\u003cp align=\"center\"\u003eScreenshot-safe: designed to hide in plain sight.\u003c/p\u003e**\n\n\n![BatBar](https://raw.githubusercontent.com/simonquasar/BatBar/main/BatBar.jpg)\n\n**BatBar** sits on the extreme edge of your screen - typically outside the active capture area used by most print screens.\n\n_You can still increase its width, while 1px remains the sweet spot for invisibility!_\n\n**\u003cp align=\"center\"\u003eIdeal for streamers, designers and screen recorders!\u003c/p\u003e**\n\n---\n\n\n## Usage\n\n**\u003cp align=\"center\"\u003eNon-intrusive design: minimalism taken seriously.\u003c/p\u003e**\n\nThe bar automatically appears on the right edge of your primary screen.\n\n- ↔️ **Adjust width** (1-10 px) with `mouse wheel up/down` \n- ❌ **Close** with `SHIFT + right-click` on it\n\nThat's all!\n\n---\n\n\n## Resources\n\nRuns silently in the background without impacting system performance.\n\nThis widget is designed to be extremely lightweight (both visually and on system resources):\n\n- **Size**: `51KB .exe` | `~12MB deb` | `~6KB .ps1 \u0026 .py`\n- **Memory**: \u003c20MB RAM usage\n- **CPU**: ~0.1% idle, \u003c0.3% during updates (every 5s)\n- **Battery**: virtually zero\n\nMost battery indicators are cluttered, over-engineered, and demand system resources or some interaction.\n**BatBar** delivers pure functionality with a nearly invisible aesthetic that stays out of your way while keeping you informed.\nThe solution for who wants **instant battery awareness without distractions** and overhead.\n\n---\n\n\n## ⏬ Download\n\n**\u003cp align=\"center\"\u003eBatBar** is made for creators, coders, productivity purists and people who care about **signal over noise**.\u003c/p\u003e\n\n[![Download BatBar](https://img.shields.io/badge/BatBar-Download%20here!-ff2850?style=flat-square)](https://github.com/simonquasar/BatBar/releases/latest)\n\n[![GitHub Release](https://img.shields.io/github/v/release/simonquasar/BatBar?display_name=release\u0026color=whit\u0026labelColor=white\u0026style=flat-square)](https://github.com/simonquasar/BatBar/releases/latest) in [Github](https://github.com/simonquasar/BatBar/releases/)\n\n### Windows 10/11\n\n#### 🔹 Option 1: Standalone Executable (recommended) ✅\n1. Download the latest release (`BatBar.Windows.x86_64.exe`) [![GitHub file size in bytes](https://img.shields.io/github/size/simonquasar/BatBar/ps%2FBatBar.exe?label=.exe\u0026color=318ce7\u0026style=plastic)](https://github.com/simonquasar/BatBar/releases/latest)\n2. Run - that's it.\n\n#### 🔹 Option 2: PowerShell Script\n- requires: PowerShell 5.1+\n1. Download `BatBar.ps1` [![GitHub file size in bytes](https://img.shields.io/github/size/simonquasar/BatBar/ps%2FBatBar.ps1?label=.ps1\u0026color=1292EE\u0026style=plastic)](https://github.com/simonquasar/BatBar/releases/latest)\n2. Right-click the file and select “_Run with PowerShell_”\n\n### Linux (Debian/Ubuntu)\n\n#### Standalone Executable (recommended) ✅\n1. Download the latest release (`BatBar.Debian`) [![GitHub file size in bytes](https://img.shields.io/github/size/simonquasar/BatBar/py%2FBatBar?label=pkg\u0026color=E95420\u0026style=plastic)](https://github.com/simonquasar/BatBar/releases/latest)\n2. Make the file executable:\n   `chmod +x BatBar`\n3. Run:\n   `./BatBar`\n\n### Linux (Arch/Unix) \u0026 MacOS\n\n#### 🔹 Python Script\n- requires: Python 3.7+ and the `psutil` package\n1. Download `BatBar.py` [![GitHub file size in bytes](https://img.shields.io/github/size/simonquasar/BatBar/py%2FBatBar.py?label=.py\u0026color=84A454\u0026style=plastic)](https://github.com/simonquasar/BatBar/releases/latest)\n2. Install the required dependency:\n   `pip install psutil`\n3. Run with:\n   `python3 BatBar.py`\n\n---\n\n## License\n\nThis project is licensed under the **GNU General Public License v2.0**\nSee the full license text [here](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html).\n\n\n\n👤 _Crafted with minimalism by [simonquasar](https://www.simonquasar.net)_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonquasar%2Fbatbar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimonquasar%2Fbatbar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonquasar%2Fbatbar/lists"}