Control your first-generation Xiaomi YI Action Camera from a modern Android phone.
Free and open source, by Mistere Tech
English · Italiano
ControllaMI is a free, open-source Android app for the Xiaomi YI Action Camera, first generation (the original YI released in 2015, model YDXJ01XY).
The official YI app is no longer updated and often does not work on recent phones. ControllaMI replaces it with a modern 64-bit app that talks to the camera directly over its Wi-Fi.
👉 Download the latest version (APK)
- Open the link on your phone and download
ControllaMI-vX.Y.Z-arm64.apk. - Open it: Android asks you to allow "install unknown apps" for your browser. Confirm.
- Turn on the camera's Wi-Fi, connect the phone to its network (
YDXJ_…) and open ControllaMI.
Updates: at startup the app checks for a new version and, if there is one, asks you to install it before going on (for security, only the latest version is used). Tap "Download and install" and confirm with "Install".
Requirements: a 64-bit Android phone (arm64, which is almost every phone from recent years). The app is not on the Play Store.
- Simple mode: 1080p 60 fps video at the highest bitrate, photos at the highest quality, video or photo timelapse with the interval you choose, exposure adjustment. The app sets up the camera for you.
- Pro mode: every camera setting, by hand. Your Pro settings are kept when you switch between modes.
- Live view from the camera, which recovers by itself if it stops
- Connection indicator (stable, unstable or lost) with automatic reconnection
- On Android 10+ the app connects to the camera's Wi-Fi by itself: no "no internet" prompt, mobile data stays on for other apps
- Gallery: list of files, download to the phone's gallery, delete
- Camera date and time set from the phone at every connection (the YI forgets it when the battery is removed)
- Clear messages when a command fails (for example, no SD card)
- Italian and English, following the phone's language
- Demo mode with a simulated camera, to try the app without a camera
| Camera | Supported |
|---|---|
| Xiaomi YI Action Camera, first generation (YDXJ01XY) | ✅ the camera this app is made for |
| YI 4K, YI 4K+, YI Lite, YI Discovery and later | ❌ not supported |
🧪 First public version (0.1.x). Tested on a first-generation YI: live view, photo, video, timelapse, settings and gallery download work. The protocol is covered by automated tests, but the app has not been tried with every firmware version yet. If something does not work with your camera, please open an issue with your phone model, Android version and camera firmware.
Known issue on Android 10 and later: when you connect to the camera's Wi-Fi, Android may ask "This network has no internet access. Stay connected?". Answer yes.
The code is open and contributions are welcome: bug reports, tests with your own camera, pull requests.
npm install
npx expo install --fix
npm test # protocol and logic tests
npm run mock # fake YI on port 7878
npx expo run:android # build and install on a phone connected via USBTo try the app against the mock: phone and PC on the same network; in the app tap Advanced and enter the PC's IP address.
Built with React Native 0.88 + Expo SDK 58 (New Architecture, development build, not Expo Go) and a small native module in Kotlin.
The GitHub Action android.yml builds the app on every push to main (the APK is available as an artifact of the run). When a v* tag is pushed, for example:
git tag v0.1.0
git push origin v0.1.0the same Action publishes a Release with the APK attached, which is what people download.
APKs are signed with the project's release key, kept in GitHub Secrets: that is what lets updates install over the existing app. Builds from forks and pull requests, which cannot read the Secrets, are signed with Expo's debug key.
app/ screens (expo-router): connection + Control / Gallery / Settings tabs
src/core/ YI protocol, plain TypeScript, tested
jsonStream.ts parser for the back-to-back JSON objects arriving over TCP
YiClient.ts session/token, command queue, timeouts, notifications, expired token
CameraController.ts app state, reconnection, REC/photo, settings, files
fakeCamera.ts simulated camera (tests, mock server, demo)
src/net/ TCP (react-native-tcp-socket) and gallery download
modules/yi-native/ native Expo module in Kotlin: Wi-Fi binding and RTSP player
mock/mockServer.ts fake camera over TCP
tests/ node:test tests (npm test)
The camera runs a TCP server on 192.168.42.1:7878 that speaks JSON. Files are downloaded over HTTP from http://192.168.42.1/DCIM/<folder>/ (100MEDIA, 101MEDIA, …) and the live view is at rtsp://192.168.42.1/live.
| msg_id | What it does |
|---|---|
| 257 / 258 | open / close the session (token) |
| 3 / 9 / 2 | all settings / allowed options / change a setting |
| 13 | battery |
| 513 / 514 | start / stop recording |
| 769 | photo |
| 259 | start the live view stream |
| 1283 / 1282 / 1281 | cd / list / delete files |
| 7 | camera notifications (REC started/stopped, photo taken…) |
These codes come from community documentation and may vary with the firmware.
MIT: you are free to use, modify and redistribute the code.
ControllaMI is an independent project, not affiliated with Xiaomi or YI Technology. Xiaomi and YI are trademarks of their respective owners.