https://github.com/nvhai245/xbox-controller-battery-linux
Xbox Controller Battery Indicator for Linux
https://github.com/nvhai245/xbox-controller-battery-linux
linux-gaming xbox xbox-controller
Last synced: 4 months ago
JSON representation
Xbox Controller Battery Indicator for Linux
- Host: GitHub
- URL: https://github.com/nvhai245/xbox-controller-battery-linux
- Owner: nvhai245
- License: mit
- Created: 2025-05-30T08:34:48.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-05T08:08:12.000Z (about 1 year ago)
- Last Synced: 2025-12-18T09:15:26.475Z (6 months ago)
- Topics: linux-gaming, xbox, xbox-controller
- Language: Go
- Homepage:
- Size: 147 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Xbox Controller Battery Indicator for Linux
A simple system tray app that displays the battery level of your Xbox controller on Linux.
Light + Dark mode available.
---
## 🛠️ Installation
### Arch Linux
1. Download the `.pkg.tar.zst` package from the [Releases](https://github.com/nvhai245/xbox-controller-battery-linux/releases) page.
2. Install it using:
```bash
sudo pacman -U xbox-controller-battery-linux-*.pkg.tar.zst
```
---
### Debian / Ubuntu / Linux Mint
1. Download the `.deb` package
2. Install it using:
```bash
sudo dpkg -i xbox-controller-battery-linux_*.deb
```
---
### Fedora / Nobara / Bazzite
1. Download the latest .rpm package
2. Install it using:
```bash
sudo dnf install ./xbox-controller-battery-linux-*.rpm
```
## 🖥️ Run the App
After installation, launch the app from your application menu or run:
```bash
xbox-controller-battery-linux
```
---
🔄 Auto-start on Login
To make the app start automatically after login:
Create a .desktop file in your autostart directory:
```
mkdir -p ~/.config/autostart
cp /usr/share/applications/xbox-controller-battery-linux.desktop ~/.config/autostart/
```
## 🛠️ Build From Source
```bash
git clone https://github.com/nvhai245/xbox-controller-battery-linux
cd xbox-controller-battery-linux
go build -o xbox-controller-battery-linux
./xbox-controller-battery-linux
```
---
## 📄 License
MIT License
---
## 🙌 Contributions
Pull requests and suggestions are welcome! 🎮