Troubleshooting & Known Bugs
Troubleshooting methods, FAQs, knowledge, and known bugs.
Hardware Issues
Thumbsticks
Why does my right thumbstick feel sticky?
If you own a Blue, Pink, or Orange from the beta batch, most likely your right stick is a little close to the shell, the fix is luckily pretty simple: Pop the cap off and add 2 tiny pieces of paper under joystick for smoother movement.
Why does my left thumbstick make a clicking sound?
If you own a beta batch unit, your left stick most likely has a notable clicking sound as you move it around, this fix means rolling up your sleeves, opening the shell, and making a modification.
Battery
Why does my RP2 shut down when the battery still has plenty of power? Why does my RP2 take forever to recharge?
Currently (September 2020), software installed on the RP2 at the factory is working with an incorrect battery capacity value. As a result, the power usage estimation algorithms (and therefore the battery meter) are not working properly. They should be taken as a rough estimate at best. Also, the RP2 is currently set to automatically shut down when remaining power capacity reaches 15%. This is fixed to a lower value (7%) in the new firmware (upcoming).
Screen
Why does my RP2 have lightbleed?
Some people will notice a little bit of light bleed in the lower left or lower right of their screen. The amount of left side bleed can be influenced by the different RP2 plastic colors.
Light may also show 'green' around the edges when first booting up, this tends to go away within 48 hours.
Lightbleed may also be fixed by pushing down lightly on the screen in all 4 corners, to confirm its seated firmly. To fix permanent light issues, look for the the screw that lives just under where your screen bleed is happening, this screw is most likely a bit too tight from the factory. Loosening this screw one half turn will relieve pressure and reduce light-bleed issues.
Software Issues
Emulation (RetroidOS)
How do I add my own games to RetroidOS?
See the guide here: Adding your own ROMs to RetroidOS.
Emulation (Retroarch)
How do I delete a core from Retroarch?
It is not possible to delete individual cores from within Retroarch on Android. See here for more details: Deleting a core from Retroarch.
Emulation (Stand-alone)
Why doesn't my d-pad work in some emulators?
If you can't map the RP2's d-pad to the controller d-pad in Mupen64Plus FZ, make sure that in the Toolbox app the 'Joystick mode toggle' setting is NOT on 'Retroarch' mode. This should fix that issue. See here for more details: Getting_Started#Joystick_Mode_Toggle. Also, be sure to turn tv mode navigation on in Mupen64Plus FZ under Settings->Input->Accessibility->Menu Navigation Mode->Big Screen Mode.