VolBtnUnlockScript_v4 (Bluetooth Version: Supports Bluetooth Headphones & X-input Controller) For R40s Pro (may also work on R36s)

[daidaigo]

⚠️ 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
(Currently tested on version R35S-R36S_v2.0_11072025 and working properly.)

📦 Download Link
Download via MEGA:

2025-11-29
https://mega.nz/file/gfhX3DyJ#tlF_p8Qmnf0jI9FYgb7mMhJCemYfsDeIqSCfKoHXSF4

🛠️ 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 nano 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 nano) 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 or R2 + Left analog stick Y-axis up → Volume Down
R2 + D-pad Right or R2 + Left analog stick Y-axis down → 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

Additional testing shows that the BSP D8 Pro controller, in X-Input mode, can be paired via Bluetooth and used as the controller for Player 2.

🔊 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

*Installing this toolkit requires the audio output for both RA and RA32 to be set to Pulse

🗓️ 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.
2025-11-07
Fix the issue where video playback has no audio output through the Bluetooth device.
2025-11-22
Remove unnecessary services from the previous version and add a script to check the Bluetooth environment, CheckBt.sh.
2025-11-25
Streamline the conditional statements in the Bluetooth device volume control script.
2025-11-29
Since the joystick controls in the video overlap with the above Control Mapping, add R2 + Left Analog Stick Up/Down to control volume.
Changed Bluetooth volume step from ±2% to ±1%.

⚠️ 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.

I don’t mind if anyone modifies this tool package. If someone can optimize it and share it for everyone to use, I’d be very happy.

[ElMoNo22]

Working on R36s Clone with ARK OS 2.0 (07312025-1) AeolusUX (both Bluetooth headphones and PS4 Joystick)

[TheLastHairBender]

Working just fine. You really deserve thousands of thanks, mate.

[Bineez]

Hello, I am having problems playing games when Bluetooth is connected to the speaker. I have tried all the steps as instructed but there is no response. What should I adjust for the RA part in the audio?

[Bineez]

Hello, last night I did an experiment as follows: Like I said I have 2 r36s. my old one runs arkos 05152025 and the new one runs arkos 07312025-1. The old device is now connected via Bluetooth to the headphones and speakers, and the sound is very good. As for the r36s running 07312025-1, there is no sound and the connection is unstable. I removed the card from the old phone (05152025) and put it in the new r36s (07312025-1). To my surprise, it still connected to Bluetooth and made sound. But when I insert the Arkos card (07312025-1) to connect Bluetooth, sometimes it works, sometimes it doesn't. Maybe I'm thinking that it could be because of your Bluetooth installation package or not?

[Bineez]

The memory card running Arkos (05152025) has previously installed the Bluetooth package and is still normal and stable. but when I use another card and the same version 05152025, the Bluetooth audio connection is not stable. I have tried many of my memory cards to install different versions of Arkos on my old r36s but they are all unstable. Thank you for reading

[Bineez]

Maybe I was lucky to install the Bluetooth package on my arkos successfully

[daidaigo]

Sorry, I don’t have multiple devices to test with. The reason I created this package in the first place was because I accidentally broke the micro switch of the volume button while disassembling the device, causing it to malfunction — that’s how this tool came about.

To troubleshoot the issue, I can only ask you to perform cross-testing on your own.
I suggest keeping the test setup as simple as possible: use the same system memory card and the same OTG device on both your old and new R36S units.
If there’s still a difference between them, then I think… it probably isn’t a software issue.

[Bineez]

I really like this feature, it helps me connect a wireless controller and wireless headset to play thrilling games. Thank you for creating it

[AeolusUX]

@daidaigo Does this work without touching the working volume buttons?

[daidaigo]

Sorry, I didn’t fully understand your issue.
Because the volume buttons on my device are broken, I wrote this script tool and also modified and recompiled the script content of the ogage service.
If needed, I can provide the uncompiled source files.

[AeolusUX]

Sorry, I didn’t fully understand your issue. Because the volume buttons on my device are broken, I wrote this script tool and also modified and recompiled the script content of the ogage service. If needed, I can provide the uncompiled source files.

Oh yeah please do, I'd like to know if I can add this to the community image for people that haven't broke their volume buttons :D

[daidaigo]

Below is the uncompiled source file of ogage that I modified. I’m not entirely sure if my changes are completely correct—please take a look:
https://mega.nz/file/lfY23BLS#LxePJxmCk7CMDAsv1PuAbYtqqf1qmXHUVVKQkpVEwuY

[daidaigo]

Actually, one of the scripts in this package (Bluetooth.sh: Bluetooth-dialog) was ported from another system, XD.
Previously, I installed and tested it on ArkOS 2.0 (09292024).

[daidaigo]

I’ve made some corrections; please take a look.

1.Fix the issue where video playback has no audio output through the Bluetooth device.

https://mega.nz/file/5XQ0FIQD#d7Bi8BmCsHVBZpSePH9_N76ShbIJE_cYRtaM1i2texw

nano /etc/pulse/system.pa
find
load-module module-native-protocol-unix

replace
load-module module-native-protocol-unix auth-anonymous=1

[Ammaster27]

Do your t2ub need to install driver? I use a diff wifi + bt adapter but same rtl8812cu chip. I have to install a wifi script to install driver in order for the adapter to work

[daidaigo]

From my previous tests with ArkOS 2.0 (09292024) up to the latest version ArkOS 2.0 (11072025),
the OTG device I’m using — the TP-Link T2UB Nano — works without installing any drivers;
both Wi-Fi and Bluetooth function normally.

However, as mentioned above, Bluetooth will only work properly if the system is completely powered off and then turned back on — it does not initialize correctly after a simple reboot.

[Ammaster27]

So i have to go to menu, shutdown system and then turn it back on so bt can work right? Also can i change the volume with the volume button?

[daidaigo]

1.yes
2.Able to control the volume of connected Bluetooth devices using the volume buttons.

[sbrumfield6304-ux]

I am using an r36xx with an internal bluetooth chip and this allows me to turn bluetooth on and off but pairing will not work (it will just say “scanning for available bluetooth devices” for a few seconds, then go back to the bluetooth menu)

[daidaigo]

Since my device is an OTG Bluetooth device, this tool is designed specifically for OTG Bluetooth devices. I’m not very familiar with issues related to built-in Bluetooth devices. Sorry about that.

If it is an OTG Bluetooth device...Use the old script to remove the tool first. Then download version 2025-11-22, which includes a Bluetooth check script. Place it in the Ports directory, open PORTS in the system interface, run BTCHECK, and ensure your OTG Bluetooth device is working properly.

[Ammaster27]

Hey i have a question, the adapter u use to be exact is the t2ub NANO right?

[daidaigo]

Yes, Tp-Link T2UB nano.

[Ammaster27]

i have buy a t2ub nano and tested the bluetooth function, everything work fine except the slight delay when using the voulume button to change the volume, like if i dont be careful my ear can explode hehe, don't know if it a bug or not but i think it still good to post on here

[daidaigo]

Download the installation package dated 2025-11-25. This is a temporary version; please reinstall it and test again. Thank you.

[Ammaster27]

okay so i have a new problem, after flash a newer arkos, now wifi and bluetooth dont work anymore. the led on t2ub nano will go flashing every few sec

[daidaigo]

What device are you using? Which version of ArkOS is it?

[Ammaster27]

hi, im using a real r36s, arkos 11072025, im currently backing up my sd card to flash a new arkos again

[daidaigo]

My device is an R40s Pro (I believe it’s a clone of the R36s). After installing the latest ArkOS version 11072025 and using an OTG TP-Link T2UB nano, both Wi-Fi and Bluetooth work normally, and I did not encounter the issues you mentioned.
Additionally, after installing the toolpack version dated 2025-11-25, the adjust volume delay issue was resolved.
I think you may want to cross-check whether the problems you experienced were caused by differences in the ArkOS version.

[Ammaster27]

Thanks, i will test again

[digoXdigo]

Hello mate,
Thank you for this amazing contribution.

Your adapter has a regular type A connection + combined with a type C OTG. Is that right?
Will it work with a native type C BT adapter?
I'm specifically thinking on the UGREEN Type-C 5.3 Bluetooth adapter advertised for Nintendo Switch.

Also, after using all this time, have you encountered any other non listed issues?

[daidaigo]

Yes, my Bluetooth device is USB-A connected through a Type-A to Type-C adapter, not a native Type-C device. You can try it out — there is a Bluetooth environment diagnostic script included in the tool package.
Also, in my personal opinion, external devices may have slight electrical noise and consume more power, but it really depends on whether you need them. There are no major issues overall.

[digoXdigo]

So this direct connection probably won't make a difference, I can understand.

Of course these cheap handhelds are the basics of basics, but I cannot think other than playing it on a train with wirless earbuds connected. I mean, or at least this would be the absolute goal, but I guess by far things are really THAT advanced in technology.
Thus, the noise can be mitigated, but the battery drain is really something to think.
I'll put my tries but it seems that you took part in this great advance.
Thanks again, my man!

[daidaigo]

I searched the product information for the UGREEN Type-C Bluetooth 5.3 adapter, and it clearly states that it is not compatible with Linux. So if you’re planning to add external Bluetooth functionality to a handheld device, please do not consider using this adapter.

In general, older and cheaper USB Wi-Fi & Bluetooth dongles tend to have better system compatibility. Alternatively, you can consider the device that I purchased.

[digoXdigo]

Hey whats wrong with you, are some sort of wizard?
Not only you saved my hide from buying said adaptor, but also prophetized something:

Reason I was grabbing it was becaus I was already waiting for my r36h ProMax, which overall has amazing high quality build... But... After a 15day ship delay, it came with the R1 fucked up. lol
It's not the button itself, but the clicky box inside on the board that it's literally ripped off the board, bouncing loose inside. Absolute no chance of repair right out of the box.
It's very frustrating since this console it's pretty amazing (at least one functional lol). For the price range for Horizontals, I don't know if there is anything better.

So yeah, guess you and Aliexpress MOFOs made another oportunity appear to lurk moar for a better (not that this one wasnt) choice at this time.
But I guess this is getting off topic right? lmao

[daidaigo]

Based on my experience with multiple online purchases, if an item is shipped directly from China and is priced quite cheaply, there’s a high chance it may have some defects or be a simplified version of what’s shown on the website. I guess… sellers count on you finding the return process troublesome, so you won’t bother requesting a return or refund. If the platform you’re buying from offers a guaranteed refund mechanism, make good use of it.

[Ammaster27]

Do this work on the newly released darkos?

[daidaigo]

I will try flashing the new system version during my free time and test whether this toolkit works properly. However, since the new system has just been released, its stability is still uncertain and may require some time for further observation.

[Andre3ee]

i have a bt 3.5 dongle with barrot chipset ( bought on temu), the console detect the bluetooth and coonects to my earbuds, but the problem is that i dont hear nothing, the audio keeps coming out from the console speakers and not from my earbuds, i tried switching audio driver in RA to alsathread but didnt work, i tried changing audio card in the menu but nothing.
i know the bt dongle that i bought might be shit bcs from temu but It's strange that I was able to activate Bluetooth on the console and then also connect it to the headphones, so all this makes me think it might be possible and maybe there's a way.
If anyone can help me, I'd be very grateful.

[daidaigo]

Installing this toolkit requires the audio output for both RA and RA32 to be set to Pulse. Please give it a try.

[Andre3ee]

I also tried with pulse and nothing changes
:(

[daidaigo]

Have you confirmed that the settings were saved?
Please enter RA and RA32 again and go to Audio > Output > Audio to check whether the option is still set to pulse.

[Andre3ee]

yeah i did.. seem that doesnt care what I change in the settings

[Wivi2013]

I like how it simply works but how can someone like me edit the hotkeys? they are clashing with my hotkeys that I use on RetroArch

[Kurtcocainehehe]

It doesn't seem to scan devices for me. It recognises my dongle and such but whenever I turn Bluetooth on and then try scanning for devices it doesn't find any devices. I use a generic dongle through a OTG adaptor. I don't have WiFi on my R36S. It's a G80C V1 clone running Arkos for G80C.