{"id":24905962,"url":"https://github.com/wizardous/battery-lamp","last_synced_at":"2026-05-03T13:41:10.779Z","repository":{"id":274961135,"uuid":"922398362","full_name":"Wizardous/Battery-Lamp","owner":"Wizardous","description":"A Python project to add a battery status icon to the system tray on your Windows device.","archived":false,"fork":false,"pushed_at":"2025-01-30T11:10:34.000Z","size":461,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T12:22:13.014Z","etag":null,"topics":["battery-level","battery-monitor","system-tray","windows"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Wizardous.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":"2025-01-26T04:50:12.000Z","updated_at":"2025-01-30T11:10:38.000Z","dependencies_parsed_at":"2025-01-30T12:22:15.111Z","dependency_job_id":"add009b9-433c-456b-aa4b-c7407c2ca607","html_url":"https://github.com/Wizardous/Battery-Lamp","commit_stats":null,"previous_names":["wizardous/battery-lamp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wizardous%2FBattery-Lamp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wizardous%2FBattery-Lamp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wizardous%2FBattery-Lamp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wizardous%2FBattery-Lamp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wizardous","download_url":"https://codeload.github.com/Wizardous/Battery-Lamp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245931759,"owners_count":20695959,"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-level","battery-monitor","system-tray","windows"],"created_at":"2025-02-02T00:26:21.419Z","updated_at":"2026-05-03T13:41:10.773Z","avatar_url":"https://github.com/Wizardous.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Battery Lamp\n\nA Python project to add a battery status icon to the system tray on your Windows device.\n\n**Preview**  \n![](assets/images/screenshot/battery_lamp_pinned_not_charging_71.png)\n\n## Motivation\n\n'Battery Lamp' was created out of the need to have an effortless and clear view of my device’s exact battery percentage directly on the taskbar. Windows doesn't provide this information without an extra click and only shows a vague icon. By having 'Battery Lamp' update the battery status in real-time, it ensures that I know precisely when to plug in my charger and avoid the stress of surprise low battery notifications.\n\n## How to Use Battery Lamp\n\n**Requirements:** \n- Operating System: **Windows 10 or 11**.\n- [Python 3](https://www.python.org/downloads/windows/) installed on the system.\n\n*It is recommended to install Python with version 3.9 or higher. Python 3.8 and older version have reached their end of life.*\n\n**Execution Steps:**\n\n\n1. Clone the project or download `battery_percentage.pyw` from the src directory.\n\n2. Install the dependencies mentioned in the `requirements.txt` file.\n\n3. (Optional but recommended) **Set up Battery Lamp to run automatically at startup:**\n   - Use the provided automation script: Run `setup-startup.py` from the `utils` directory. This script will add Battery Lamp to your Windows startup folder, so it launches automatically when you log in.\n   - The script uses the `setup_config.json` file to determine the configuration, such as the path to your Python executable and the script location. You can edit `setup_config.json` to customize these settings before running the script.\n   - To run the script, open a terminal in the project directory and execute:\n     ```powershell\n     python utils/setup-startup.py\n     ```\n   - If you wish to remove Battery Lamp from startup, you can run the script again and follow the prompts.\n\n4. If you do **not** wish to use the automation script, you can manually add Battery Lamp to Windows startup:\n   - Press `Win + R`, type `shell:startup`, and press Enter. This opens your Startup folder.\n   - Create a shortcut in this folder that points to your Pythonw executable and the `battery_percentage.pyw` script. For example:\n     - Target: `C:\\Path\\To\\pythonw.exe C:\\Path\\To\\battery_percentage.pyw`\n   - Make sure the shortcut uses `pythonw.exe` (not `python.exe`) to avoid opening a console window.\n   - Optionally, set an icon for the shortcut using the provided icon in `assets/images/icon/battery_lamp_icon.ico`.\n\n5. To run Battery Lamp immediately (without rebooting), execute the script using a Command Prompt or PowerShell instance with the command:\n\n   ```powershell\n   pythonw src/battery_percentage.pyw\n   ```\n\n   This step is useful if you want to test or use Battery Lamp right away, without waiting for your next Windows restart or login. Running this command will immediately launch the tray icon and start showing your battery percentage, so you can confirm everything is working as expected. The program will run in the background, and you can close the terminal window after running the command.\n\n\u003e [!NOTE]  \n\u003e The 'w' in `pythonw` is crucial as it ensures the script runs without keeping the console busy. In other words, you can continue using the terminal after you ran the above command or close it, the lamp will run in the background.\n\n**Result:**\n\nIf all the above steps are completed correctly, a new icon will appear in the system tray displaying the battery percentage.\n\n\u003e [!TIP]  \n\u003e You might need to pin the icon to the taskbar by dragging it out from the hidden icons list in the system tray panel.  \n\u003e \u003cimg src=\"assets/images/screenshot/drag_out_to_pin.gif\" width=250\u003e\n\n**Closing the Program:**\n\nRight-clicking on the icon will display a context menu with an \"Exit\" option. Clicking \"Exit\" will close the program.\n\n## Preview\n\nHere are different ways the Battery Lamp will glow under different battery status conditions.\n\n|              |Not Charging|Charging|\n|--------------|------------|--------|\n|Charge at 100%|![](/assets/images/preview/100_not_charging_64x64.png)|![](/assets/images/preview/100_charging_64x64.png)|\n|Charge at 71% |![](/assets/images/preview/71_not_charging_64x64.png)|![](/assets/images/preview/71_charging_64x64.png)|\n|Charge at 15%^|![](/assets/images/preview/15_not_charging_64x64.png)|![](/assets/images/preview/15_charging_64x64.png)|\n\n\u003e *^ Below critical charge threshold of 20%, later versions should provide an option to change this threshold.*\n\n## Roadmap\n\nHere are some exciting features being considered for future versions, ordered by complexity of implementation:\n\n1. Ability to set custom critical battery threshold.\n2. Customizable update frequency for battery status checks.\n3. More themes.\n4. Themes customiser and preview UI.\n5. More options in the context menu.\n6. Quick access settings from the system tray.\n7. Detailed battery health statistics report exports.\n8. Graphical dashboard for detailed statistics.\n9. Actions server.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwizardous%2Fbattery-lamp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwizardous%2Fbattery-lamp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwizardous%2Fbattery-lamp/lists"}