VolBtnUnlockScript_v4 (Bluetooth Version: Supports Bluetooth Headphones) For R40s Pro (may also work on R36s) #196

⚠️ Sorry, my English is limited — the following was translated by ChatGPT.

"First of all, thank you to the author for integrating this system. The following is my experience using this system on R40s Pro hardware."

✅ Supported System
https://github.com/AeolusUX/ArkOS-R3XS
(I forgot the exact version; if needed, I can power on the device and check it.)

📦 Download Link
Download via MEGA:
https://mega.nz/file/NTYVTZ6A#_hKKefOSkOoGXAdHeeb7Gkzg-BVv0Y4ZsJBErFDlGSU

🛠️ Reason for Creation
While disassembling my R40s Pro, I accidentally broke the solder pins on the volume button micro-switch, which caused the volume keys to stop working. That led me to create this script as a workaround.

👤 Target Users
Users with broken volume buttons
Users who want to use Bluetooth headphones (Please make sure your system is backed up before installation.)

🔧 How to Install
VolBtnUnlockScript_v4 (Bluetooth version):
Requires an OTG Bluetooth adapter — I'm using the TP-Link T2UB model.
Extract the ZIP file.
Place the 3 extracted files into the ports directory on either SD Card 1 or SD Card 2.
(The script auto-detects the directory now — no need to force it onto Card 1.)
Run “VolBtnUnlockScript_v4” from the Ports section.

⚠️ Important Notes
Not all Bluetooth adapters will function properly — install at your own discretion.
Some adapters (e.g., TP-Link T2UB) may not function correctly after a system reboot. → If that happens, power off the device completely, then power it back on and try again.

🎮 Control Mapping
R2 + D-pad Left → Volume Down
R2 + D-pad Right → Volume Up
R2 + L1 → Toggle Mute / Unmute (Note: You must release the R2 button first for the toggle to work.)
R2 + R3 or FN + R3 → Toggle Bluetooth On/Off

🔊 Audio Output Settings
To ensure the volume bar displays correctly during volume changes:
When using Bluetooth headphones: → Set the audio card to default
When using the built-in speaker: → Set the audio card to sysdefault

🗓️ Update History
2024-10-24
Updated some conditional logic in the hotkey script.
2024-10-24-1
Fixed an error in the logic that caused volume adjustment to fail.
2024-10-24-2
Changed Bluetooth volume step from ±1% to ±2%.
Prevented the hotkey service from restarting when Bluetooth is toggled.
2024-10-25
Added an uninstall script to restore factory settings.
Updated Bluetooth disabling behavior to not stop the pulseaudio service.
2024-10-25-1
Tweaked pulseaudio service parameters to raise priority and reduce audio popping/crackling.

⚠️ Note: So far, during testing, this script does occasionally cause audio popping in games.
I’ve optimized the settings — please test it again and provide feedback.

💬 Feedback Welcome
If you run into issues or have technical questions, feel free to reply or discuss.
I’ll try to find time to research and provide updates. Thank you!
Let me know if you want a condensed or more formal version for a README or release note.