https://github.com/bguerradev/bluetoothvolumelock
Bluetooth Volume Lock is a service designed to keep media volume constant on Android. Android 15 (API 34) automatically lowers the volume for safety reasons. It's ideal for users who exercise with headphones and want to keep their volume constant.
https://github.com/bguerradev/bluetoothvolumelock
android android-15 automation bluetooth foreground-service-android gym-app kotlin service-android volume-control
Last synced: 2 months ago
JSON representation
Bluetooth Volume Lock is a service designed to keep media volume constant on Android. Android 15 (API 34) automatically lowers the volume for safety reasons. It's ideal for users who exercise with headphones and want to keep their volume constant.
- Host: GitHub
- URL: https://github.com/bguerradev/bluetoothvolumelock
- Owner: bguerraDev
- License: mit
- Created: 2025-04-02T11:00:43.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-04-02T11:40:49.000Z (3 months ago)
- Last Synced: 2025-04-02T12:33:27.955Z (3 months ago)
- Topics: android, android-15, automation, bluetooth, foreground-service-android, gym-app, kotlin, service-android, volume-control
- Language: Kotlin
- Homepage:
- Size: 104 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
- Contributing: CONTRIBUTING.en.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎧 Bluetooth Volume Lock
**Bluetooth Volume Lock** is an Android service that **keeps your media volume steady** when you connect Bluetooth headphones. On Android 15+ (API 34), the system automatically reduces the volume to a "safe level" when using headphones at high volume for a prolonged time.
> This app solves that issue by restoring your original volume automatically — ideal for gym sessions 🏋️♂️ or extended headphone use.
---
## 🔧 Features
- ✅ Monitors Bluetooth connections
- 🔊 Restores original media volume if Android lowers it for safety
- 📲 Runs as a **foreground service**
- 🧪 Currently compatible with **Android 15 (API 34)** only
---
## 📸 Screenshot
*(TODO)*
---
## 📦 Installation
1. Clone the project:
```bash
git clone https://github.com/bguerraDev/BluetoothVolumeLock.git
```
2. Open it in Android Studio
3. Replace `targetMacAddress` and `device.name` with your own
4. Connect your device
5. Run the project
6. Manually grant the **Nearby Devices** permission on your phone
---
## 🧪 Start the service manually using ADB
Use this command:
```bash
adb shell am start-foreground-service -n com.bryanguerra.bluetoothvolumelock/.BluetoothVolumeService
```
---
## 💡 Recommendations
- Make sure you have permission to modify system volume (API 34+ needs additional permission)
- Requires access to nearby devices (`BLUETOOTH_CONNECT` on Android 15)
---
## 📃 License
This project is licensed under the **MIT License** – see the [LICENSE](./LICENSE) file for details.
---
### 🤖 Built with Kotlin + Android Studio
