{"id":46064403,"url":"https://github.com/ikineticate/bluegauge","last_synced_at":"2026-03-01T12:05:17.575Z","repository":{"id":254604827,"uuid":"847010556","full_name":"iKineticate/BlueGauge","owner":"iKineticate","description":"A lightweight tray tool for easily viewing the battery level of Bluetooth devices - 轻松查看蓝牙设备电池电量的轻便托盘工具","archived":false,"fork":false,"pushed_at":"2026-02-19T10:15:23.000Z","size":2370,"stargazers_count":374,"open_issues_count":6,"forks_count":14,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-19T14:58:20.339Z","etag":null,"topics":["battery","battery-level","bluetooth","bluetooth-battery","bluetooth-classic","bluetooth-low-energy","windows"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iKineticate.png","metadata":{"files":{"readme":"README-en.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-08-24T15:38:14.000Z","updated_at":"2026-02-19T12:48:23.000Z","dependencies_parsed_at":"2025-01-11T14:18:52.239Z","dependency_job_id":"3c728486-1966-4565-b8c0-8e2e9296bdd4","html_url":"https://github.com/iKineticate/BlueGauge","commit_stats":null,"previous_names":["ikineticate/bluegauge"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/iKineticate/BlueGauge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iKineticate%2FBlueGauge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iKineticate%2FBlueGauge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iKineticate%2FBlueGauge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iKineticate%2FBlueGauge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iKineticate","download_url":"https://codeload.github.com/iKineticate/BlueGauge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iKineticate%2FBlueGauge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29969243,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T11:43:06.159Z","status":"ssl_error","status_checked_at":"2026-03-01T11:43:03.887Z","response_time":124,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","bluetooth","bluetooth-battery","bluetooth-classic","bluetooth-low-energy","windows"],"created_at":"2026-03-01T12:05:16.922Z","updated_at":"2026-03-01T12:05:17.564Z","avatar_url":"https://github.com/iKineticate.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BlueGauge\nA lightweight tray tool for easily viewing the battery level of your Bluetooth devices.\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/iKineticate/BlueGauge/releases/latest\"\u003e\u003cimg alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/iKineticate/BlueGauge?\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://github.com/iKineticate/BlueGauge/releases/latest\"\u003e\u003cimg alt=\"Github Downloads\" src=\"https://img.shields.io/github/downloads/iKineticate/BlueGauge/total?logo=github\"\u003e\u003c/a\u003e\n    \u003cimg alt=\"Language\" src=\"https://img.shields.io/badge/build-Rust-yellow?logo=rust\"\u003e\n    \u003ca href=\"https://github.com/iKineticate/BlueGauge#\"\u003e\u003cimg alt=\"GitHub License\" src=\"https://img.shields.io/github/license/iKineticate/BlueGauge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/app.png\" alt=\"App Screenshot\" style=\"width: 100%; max-width: 100%; height: auto; display: block;\" /\u003e\n\u003c/div\u003e\n\n\u003ch3 align=\"center\"\u003e \u003ca href='./README.md'\u003e简体中文\u003c/a\u003e | English\u003c/h3\u003e\n\n## Function\n\n1. Setting: Bluetooth battery level as tray icon  \n\n\u003cdetails\u003e\n\u003csummary\u003eUse number icon (default)\u003c/summary\u003e\n\n1. check the device that needs to display the battery    \n2. set font: open tray menu -- `Settings` -- `Open Config`   \n`font_name` = `\"System Font Nmae, e.g. Microsoft YaHei UI\"`  \n`font_color` = `\"Hex color code，e.g. #FFFFFF、#00D26A\"` (Default font color follows system theme)  \n    Restart BlueGauge after updating the configuration\n3. others: set the icon color to the connection color in `Settings`-`Tray Options` (connected as green, disconnected as red)\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"screenshots/battery.png\" style=\"width=90%; display:block; margin:0 auto 10px;\" /\u003e\n    \u003cdiv style=\"display:flex; justify-content:space-between; width:100%; margin:0 auto;\"\u003e\n        \u003cimg src=\"screenshots/connect.png\" style=\"width:45%; display:block;\"\u003e\n        \u003cimg src=\"screenshots/disconnect.png\" style=\"width:45%; display:block;\"\u003e\n    \u003c/div\u003e\n\u003c/div\u003e\n\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n\u003csummary\u003eUse ring icon\u003c/summary\u003e\n\n1. check the device that needs to display the battery    \n2. open tray menu - `Settings` - `Tray Options` - `Icon Style` - `Ring Icon`   \n3. set color, open tray menu -- `Settings` -- `Open Config`  \n`highlight_color` = `\"Hex color code，e.g. #4CD082\"`( Default green, highlight color turns red when the device battery is low )    \n`background_color` = `\"Hex color code，e.g. #DADADA\"` ( The default gray color is adjusted according to the system theme, and it is not recommended to modify it )   \n    Restart BlueGauge after updating the configuration\n4. others: set the icon color to the connection color in `Settings`-`Tray Options`   \n\n\u003cdiv align=\"center\"\u003e\n    \u003cdiv style=\"display:flex; justify-content:space-between; width:100%; margin:0 auto;\"\u003e\n        \u003cimg src=\"screenshots/ring.png\" style=\"width:48%; display:block;\"\u003e\n        \u003cimg src=\"screenshots/ring_low_battery.png\" style=\"width:48%; display:block;\"\u003e\n    \u003c/div\u003e\n    \u003cimg src=\"screenshots/ring_custom.png\" style=\"width=90%; display:block; margin:5 auto 10px;\" /\u003e\n\u003c/div\u003e\n\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n\u003csummary\u003eUse battery icon\u003c/summary\u003e\n\nNote: Windows 10 users need the Fluent battery icon to download and install [Segoe Fluent Icons](https://aka.ms/SegoeFluentIcons)\n\n1. check the device that needs to display the battery    \n2. open tray menu - `Settings` - `Tray Options` - `Icon Style` - `Battery Icon`   \n3. others: set the icon color to the connection color in `Settings`-`Tray Options`   \n\n\u003cdiv align=\"center\"\u003e\n    \u003cdiv style=\"display:flex; justify-content:space-between; width:100%; margin:0 auto;\"\u003e\n        \u003cimg src=\"screenshots/horizontal_battery_icon.png\" style=\"width:48%; display:block;\"\u003e\n        \u003cimg src=\"screenshots/vertical_battery_icon.png\" style=\"width:48%; display:block;\"\u003e\n    \u003c/div\u003e\n\u003c/div\u003e\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eUse custom icon\u003c/summary\u003e\n\n1. create an `assets` folder in the BlueGauge directory\n    - Default：add `0.png` to `100.png`   \n    - Follow system theme：In the `assets` folder, create the `dark` and `light` folders respectively, and add `0.png` to `100.png` photos respectively\n2. restart BlueGauge  \n\n\u003c/details\u003e\n\n2. Settings: Show the (connected) devices with the lowest battery\n\n    Note: After setting up, you cannot manually select the device that needs to show the battery level. If you need to manually select the device that needs to show the battery level, please turn off this option.\n\n3. Setting: Bluetooth device name aliases\n\n    1. open tray menu -- `Settings` -- `Open Config`   \n\n    2. Add the required Bluetooth device alias under `[device_aliases]` (note that you use quotation marks to wrap the name)\n\n        - e.g. `\"Bluetooth device name\" = \"Bluetooth alias\"`\n        - e.g. `\"WH-1000XM6\" = \"Sony Headphones\"`\n        - e.g. `\"Surface Pen\" = \"Pen\"`\n        - e.g. `\"HUAWEI FreeBuds Pro 5\" = \"HUAWEI FreeBuds\"`\n\n4. Setting: tooltip\n\n    - Shows unconnected devices\n    - Truncate devices Name\n    - Changing the device power location\n\n5. Setting: notice\n\n    - Low battery notice\n    - Notification when reconnecting the device\n    - Notification when disconnecting the device\n    - Notification when adding a new device\n    - Notification when moving a new device\n    - Notifications stay on the screen\n\n6. Setting: Auto start\n\n## Download: \n\n\n[Github](https://github.com/iKineticate/BlueGauge/releases/latest) ( Please download the x86_64 version by default, and download the ARM version for special systems Windows on ARM. )\n\n## Translation Note\n\nTranslations are AI-generated and may contain errors. Please help improve them by [reporting issues](https://github.com/iKineticate/BlueGauge/issues/new/choose) or [submitting corrections](https://github.com/iKineticate/BlueGauge/pulls).\n\n\n## Known Issues \u0026 Suggested Solutions\n\n### 1. Currently, BlueGauge successfully retrieves battery levels from Bluetooth low-energy devices and Bluetooth Classic devices. However, we are unable to fetch the battery status from devices like AirPods and Xbox controllers, which operate on proprietary communication protocols.\n\n**Solution:**\n\nWelcome contributions from developers who can help us extend support for these devices.\n\n\n### 2. The character length of tray tooltip is currently limited. When the tooltip text exceeds this limit, it gets truncated, which can result in incomplete device names being displayed. This can cause confusion for users, especially when multiple devices are connected.\n\n**Solution:**\n\n1. **Custom Bluetooth Name**：Shorten the length of the name by giving the Bluetooth name alias.\n\n2. **Limit Device Name Length**: Implement a character limit for device names that ensures they fit within the available space of the tray notification. This may require shortening longer names to prevent truncation.\n\n3. **Hide Disconnected Devices**: Consider not displaying disconnected devices in the tray notifications. This approach would reduce clutter and ensure that only relevant information is shown, thereby preventing text overflow.\n\n### 3. How to display the battery level of multiple devices on the tray?\n\n- **Solution:**: Create another folder, copy `BlueGauge.exe` and `BlueGauge.toml` to the folder, then rename `BlueGauge.exe` to another name, and finally turn on and set the display battert level to other Bluetooth device, set the `Launch at Startup`.\n\n### 4. Connection indicator in tray tooltip has no color\n\nConnection indicator only supports displaying colors in Windows 11\n\n### 5. The battery level of the device does not match expectations\n\nIt could be that there is a problem with the device reporting (such as a cheap device) that causes only specific values to be reported, such as:\n\n- Only displays multiples of 10%, such as 10%, 20%, 30%...\n\n- Only specific values such as 0%, 50%, and 100% are displayed regularly\n\n## Other Bluetooth battery display software\n\n - Supports more devices：\n\n    - [MagicPods](https://apps.microsoft.com/detail/9P6SKKFKSHKM) (**Purchase**)   \n\n    - [Bluetooth Battery Monitor](https://www.bluetoothgoodies.com/) (**Purchase**)   \n\n - Apple: [AirPodsDesktop](https://github.com/SpriteOvO/AirPodsDesktop)\n\n - Huawei: [OpenFreebuds](https://github.com/melianmiko/OpenFreebuds)\n\n - Samsung:\n\n    - [Galaxy Buds](https://apps.microsoft.com/detail/9NHTLWTKFZNB)\n\n    - [Galaxy Buds Client](https://github.com/timschneeb/GalaxyBudsClient)  \n\n- Logitech: [elem](https://github.com/Fuwn/elem)   \n\n- SteelSeries Arctis: [Arctis Battery Indicator](https://github.com/aarol/arctis-battery-indicator)   \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fikineticate%2Fbluegauge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fikineticate%2Fbluegauge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fikineticate%2Fbluegauge/lists"}