Skip to content

Add detailed instructions for enabling Roborock app support on Android#6

Open
DonSidro wants to merge 3 commits intoPython-roborock:mainfrom
DonSidro:feature/android_roborock_patcher
Open

Add detailed instructions for enabling Roborock app support on Android#6
DonSidro wants to merge 3 commits intoPython-roborock:mainfrom
DonSidro:feature/android_roborock_patcher

Conversation

@DonSidro
Copy link
Copy Markdown
Contributor

Refactor onboarding documentation with step-by-step app integration and introduce APK patching script for Android compatibility.

…d, including APK patching and certificate bypass explanations.
@DonSidro
Copy link
Copy Markdown
Contributor Author

I've tested the steps and script end-to-end and everything is working on my end, the patched APK installs, logs in successfully, and connects to the local stack through the MITM proxy.
Would appreciate if someone else could give it a test run to confirm it works across different setups and Roborock app versions. Happy to help troubleshoot if anyone runs into issues.

@Velcorn
Copy link
Copy Markdown

Velcorn commented Apr 11, 2026

Tested with latest Roborock 4.60.06 apk. Working smoothly for me. Might want to tweak the patching instructions a little bit to account for the relative location of the patch_librrcodec.py, i.e. python(3)/uv run ../../../patcher/patch_librrcodec.py or adjusting this to be more dynamic, e.g. changing the path in the script to the full path instead of relative/assuming it's the cwd. Otherwise it's rather straight-forward after installing all dependencies.

P.S.: I love how yesterday was the day I finally wanted to cut off my Roxy from the cloud and it just so happened to be the day you published the workaround for the Android app. Kudos!

@DonSidro
Copy link
Copy Markdown
Contributor Author

Tested with latest Roborock 4.60.06 apk. Working smoothly for me. Might want to tweak the patching instructions a little bit to account for the relative location of the patch_librrcodec.py, i.e. python(3)/uv run ../../../patcher/patch_librrcodec.py or adjusting this to be more dynamic, e.g. changing the path in the script to the full path instead of relative/assuming it's the cwd. Otherwise it's rather straight-forward after installing all dependencies.

P.S.: I love how yesterday was the day I finally wanted to cut off my Roxy from the cloud and it just so happened to be the day you published the workaround for the Android app. Kudos!

Thanks for testing and the kind words! Glad it's working smoothly on 4.60.06.
Good point about the relative path, that's definitely a papercut. I'll update the script to resolve it so it works regardless of cwd, and clarify the instructions in the meantime.
And haha, what timing! Happy it landed right when you needed it. Enjoy your newly cloud-free Roxy ;)

Sidon Kodraliu added 2 commits April 11, 2026 22:53
…usability

- Added version-specific notes for Roborock app 4.60.06 in the documentation.
- Enhanced readability and clarity of patching instructions.
- Updated `patch_librrcodec.py` to support dynamic target path detection and argument-based file selection.
- Included better logging and instructions for offset patching in the script.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants