Skip to content
Back to search

oh-my-android

Android emulator & ADB GUI for Mac: dark mode, font size, RTL, TalkBack, network, GPS, Layout Inspector in dp. Built-in MCP server lets Claude Code, Codex and Cursor drive the emulator.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ateymoori/oh-my-android with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ateymoori/oh-my-android'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ateymoori--oh-my-android/badge.svg)](/listings/ateymoori--oh-my-android)

HTML

<a href="/listings/ateymoori--oh-my-android"><img src="/api/listings/ateymoori--oh-my-android/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

brew install --cask ateymoori/tap/oh-my-android

Or download the zip from the [latest release](https://github.com/ateymoori/oh-my-android/releases/latest), unzip it, and move **Oh My Android.app** to Applications. The app is signed and notarized by Apple.

**Updates:** when a new version is out, a dot shows on the menu bar icon. Click **Update to …** in the menu, read what's new, and install in one click. The app never updates without asking. It checks once a day; turn it off in **Settings → Updates**. `brew upgrade --cask oh-my-android` works too.

**Requirements:** macOS 26 Tahoe or later, Apple silicon, and the Android SDK from [Android Studio](https://developer.android.com/studio) (or `brew install --cask android-commandlinetools`). The app finds the SDK by itself. If yours is in an unusual folder, pick it in **Settings → Android SDK**.

Use it from Claude Code, Codex or Cursor

brew install --cask ateymoori/tap/oh-my-android

claude mcp add --scope user oh-my-android -- ohmyandroid-mcp   # Claude Code
codex mcp add oh-my-android -- ohmyandroid-mcp                 # Codex CLI
gemini mcp add --scope user oh-my-android ohmyandroid-mcp      # Gemini CLI

For Cursor and VS Code, use the install buttons in [AI agents (MCP)](#ai-agents-mcp). Then start an emulator and ask your agent: *"Take a screenshot of the emulator and check this screen in dark mode."*

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "oh-my-android",
  3. "owner": {
  4. "name": "Amir Teymoori",
  5. "url": "https://github.com/ateymoori"
  6. },
  7. "description": "Oh My Android: control the Android Emulator and phones from Claude Code.",
  8. "plugins": [
  9. {
  10. "name": "oh-my-android",
  11. "source": "./",
  12. "description": "Let Claude see and drive the Android Emulator and phones: screenshots in dp, UI tree, tap, dark mode, RTL, logcat. Needs the Oh My Android app."
  13. }
  14. ]
  15. }
README.md · README · 422 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="docs/icon.png" width="96" alt="Oh My Android app icon: a surprised Android robot">
  3. </p>
  4. <h1 align="center">Oh My Android</h1>
  5. <p align="center">
  6. <b>Test your Android app in dark mode, big fonts, RTL and TalkBack: one click each, no adb commands.</b><br>
  7. A free, native ADB GUI for Mac that docks next to the Android Emulator. Works with real phones too.
  8. </p>
  9. <p align="center">
  10. <a href="https://github.com/ateymoori/oh-my-android/releases/latest"><img src="https://img.shields.io/github/v/release/ateymoori/oh-my-android?label=release&color=3DDC84" alt="Latest release"></a>
  11. <a href="#install"><img src="https://img.shields.io/badge/brew-oh--my--android-FBB040?logo=homebrew&logoColor=white" alt="Homebrew cask"></a>
  12. <img src="https://img.shields.io/badge/macOS-26%2B%20%C2%B7%20Apple%20silicon-000000?logo=apple" alt="macOS 26 or later, Apple silicon">
  13. <a href="https://androidweekly.net/issues/issue-747"><img src="https://img.shields.io/badge/Android%20Weekly-%23747-3DDC84" alt="Featured in Android Weekly #747"></a>
  14. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license"></a>
  15. <a href="https://github.com/ateymoori/oh-my-android/stargazers"><img src="https://img.shields.io/github/stars/ateymoori/oh-my-android?style=social" alt="GitHub stars"></a>
  16. <a href="https://x.com/ReadmeRadar"><img src="https://img.shields.io/badge/follow-%40ReadmeRadar-000000?logo=x" alt="Follow @ReadmeRadar on X"></a>
  17. </p>
  18. <p align="center">
  19. <img src="docs/demo.gif" width="560" alt="Demo: the Oh My Android panel docked beside the Android Emulator turns on dark mode, raises the font size to 2x and switches the device to Arabic, right to left, in the Settings app">
  20. <br><sub>Dark mode, font size 2×, Arabic right-to-left: one click each.</sub>
  21. </p>
  22. ## Install
  23. ```sh
  24. brew install --cask ateymoori/tap/oh-my-android
  25. ```
  26. <sub>Or the signed, notarized zip from <a href="https://github.com/ateymoori/oh-my-android/releases/latest">Releases</a> · macOS 26 Tahoe+ · Apple silicon · uses the Android SDK you already have (<a href="#updates-and-requirements">details</a>)</sub>
  27. - **48 test actions, always visible.** Dark mode, font and display size, language and locale incl. RTL and pseudo-locales, TalkBack, bold text, layout bounds, show taps, animations off, network speed, GPS, incoming call and SMS. Each icon shows the device's real state.
  28. - **Layout Inspector in dp, for any app.** Hover a view to see its size and the gaps around it in dp, for Compose and Views alike. Drop your Figma export on top to compare design and build. ⇧⌘A numbers the TalkBack stops and flags missing labels and touch targets under 48 dp.
  29. - **Your debug build, without adb.** Read SharedPreferences and SQLite, clear data, open deep links, drag an APK to install, reset permissions.
  30. - **Native and light.** SwiftUI, event-driven, no Electron, no telemetry. Free and open source (MIT).
  31. ## Why
  32. Checking one screen before a pull request means the same chores every time: dark mode, a big font, a
  33. right-to-left language, TalkBack, a slow network. Each one is an `adb` command you look up again, or a
  34. setting three screens deep on the device. Oh My Android puts all of them in one panel next to the
  35. emulator, and every icon shows the device's real state.
  36. **Why not just Android Studio?** Studio's Device UI shortcuts already give one-click dark mode, font size,
  37. app language and TalkBack (API 33+). Use them when Studio is open. Oh My Android adds one always-visible panel
  38. for emulators *and* phones that works with Studio closed, toggles the shortcuts don't have (bold text,
  39. pseudo-locales, layout bounds, show taps, animations), and dp measurements on any app, where Studio's
  40. Layout Inspector needs a debuggable one. Compared with Studio, scrcpy and mobile-mcp: [docs/COMPARISON.md](docs/COMPARISON.md).
  41. > **Using Claude Code, Codex or Cursor?** The app ships an MCP server (18 tools) so your agent can
  42. > screenshot the emulator in dp, tap, and switch dark mode or RTL. [Set it up →](#ai-agents-mcp)
  43. <table align="center">
  44. <tr>
  45. <td align="center"><a href="#features"><img src="docs/panel.jpg" height="340" alt="The Oh My Android control panel with appearance, app, capture and network actions"></a></td>
  46. <td align="center"><a href="#layout-inspector"><img src="docs/layout-inspector-talkback.jpg" height="340" alt="Layout Inspector with dp measurements and the TalkBack order audit"></a></td>
  47. </tr>
  48. <tr>
  49. <td align="center"><b>Control panel</b></td>
  50. <td align="center"><b>Layout Inspector + TalkBack audit</b></td>
  51. </tr>
  52. </table>
  53. <p align="center">
  54. <a href="#features">Features</a> ·
  55. <a href="#no-more-adb-commands">adb cheat sheet</a> ·
  56. <a href="#layout-inspector">Layout Inspector</a> ·
  57. <a href="#ai-agents-mcp">AI agents (MCP)</a> ·
  58. <a href="#troubleshooting">Troubleshooting</a> ·
  59. <a href="#faq">FAQ</a> ·
  60. <a href="CONTRIBUTING.md">Contribute</a> ·
  61. <a href="https://royan.se/work/oh-my-android/">Website</a>
  62. </p>
  63. ## Features
  64. | | What you get |
  65. |---|---|
  66. | **Appearance** | Dark mode · Font size (0.85× → 2×) · Display size · Language and locale, incl. RTL and pseudo-locales · Rotate |
  67. | **Your app** (whatever is on screen) | Restart · Clear data · Open deep link · Install APK (or drag it onto the panel) · App info · Reset permissions · Force stop · Uninstall |
  68. | **Capture** | Screenshot saved and copied to the clipboard · Screen recording with audio · Quality presets |
  69. | **Network** | Emulate LTE, HSDPA, 3G, EDGE, GPRS or GSM speed and latency · Airplane mode · Wi‑Fi · Mobile data |
  70. | **Layout & performance** | Layout Inspector · Show layout bounds · GPU overdraw · GPU profile bars · Show taps · Pointer location · Animations off (for Espresso / Maestro) · Developer options |
  71. | **Accessibility** | TalkBack on/off · Bold text · Invert colors · TalkBack order audit |
  72. | **Navigation & input** | Back · Home · Recents · Type text into the focused field · Hide keyboard |
  73. | **Simulate** (emulator) | GPS location: city presets or latitude/longitude · Battery level · Charging · Fingerprint · Incoming call · Incoming SMS |
  74. | **Snapshots** (emulator) | Save a clean state and restore it in seconds |
  75. Destructive actions (Clear data, Uninstall, Reset permissions) ask before they run.
  76. ## Updates and requirements
  77. Besides Homebrew, you can download the zip from the [latest release](https://github.com/ateymoori/oh-my-android/releases/latest),
  78. unzip it, and move **Oh My Android.app** to Applications. The app is signed and notarized by Apple.
  79. **Updates:** when a new version is out, a dot shows on the menu bar icon. Click **Update to …** in the
  80. menu, read what's new, and install in one click. The app never updates without asking. It checks once a
  81. day; turn it off in **Settings → Updates**. `brew upgrade --cask oh-my-android` works too.
  82. **Requirements:** macOS 26 Tahoe or later, Apple silicon, and the Android SDK from
  83. [Android Studio](https://developer.android.com/studio) (or `brew install --cask android-commandlinetools`).
  84. The app finds the SDK by itself. If yours is in an unusual folder, pick it in **Settings → Android SDK**.
  85. ## No more adb commands
  86. Every icon replaces a command you would otherwise type or search for:
  87. | Task | The adb way | Oh My Android |
  88. |---|---|---|
  89. | Dark mode on the emulator | `adb shell cmd uimode night yes` | one click |
  90. | Bigger font size | `adb shell settings put system font_scale 1.3` | Aa − / + |
  91. | Change the device language | `adb shell cmd locale set-device-locale sv-SE` | pick from a menu |
  92. | Test RTL layout | `adb shell cmd locale set-device-locale ar-EG` | "العربية (RTL)" |
  93. | Slow network (3G / EDGE) | `adb emu network speed edge` + `adb emu network delay edge` | pick a profile |
  94. | Mock GPS location | `adb emu geo fix 18.0686 59.3293` | pick a city |
  95. | Turn off animations for UI tests | 3 × `adb shell settings put global …_scale 0` | one click |
  96. | Show layout bounds | `adb shell setprop debug.layout true` + a system refresh call | one click |
  97. | Clear app data | find the package, then `adb shell pm clear <package>` | one click |
  98. | Take a screenshot | `adb exec-out screencap -p > shot.png` | saved and copied |
  99. | Turn on TalkBack | `adb shell settings put secure enabled_accessibility_services …` | one click |
  100. | Open a deep link | `adb shell am start -a android.intent.action.VIEW -d "myapp://…"` | paste and open |
  101. ## Layout Inspector
  102. Freeze the screen and measure it like in Figma. Works with **Jetpack Compose** and classic **Views**.
  103. <p align="center">
  104. <img src="docs/layout-inspector.gif" width="820" alt="Layout Inspector: hover views to see their size in dp and the distances between them">
  105. </p>
  106. - Hover any element to see its size in **dp**. Click one, hover another, and see the distance between them
  107. (gaps between siblings, paddings inside a parent).
  108. - **8 dp grid**, **color picker** (hex, ⇧⌘C to copy), and an estimated text size in **sp**.
  109. - **Design overlay**: drop a Figma PNG export on the window, choose 1× / 2× / 3× or Fit width, set the
  110. opacity or use Difference blend, and nudge it with the arrow keys. Compare design and build pixel by pixel.
  111. ### Accessibility audit
  112. Press **⇧⌘A** in the Layout Inspector. Every screen-reader stop gets a number in approximate
  113. **TalkBack order**, with what TalkBack announces and a list of problems: unlabeled buttons, images
  114. without a content description, and touch targets smaller than **48 × 48 dp**.
  115. ## Data Inspector
  116. Browse the **SharedPreferences** (key, type, value) and **SQLite databases** (tables, first 500 rows)
  117. of any debuggable app, with search. It uses `adb shell run-as`, the same access Android Studio uses, so
  118. release builds stay closed. It is read-only: nothing on the device changes.
  119. ## AI agents (MCP)
  120. Oh My Android includes an [MCP](https://modelcontextprotocol.io) server, so your AI coding agent can
  121. **see and drive the emulator**: screenshot, read the UI tree in dp, tap and type, switch to dark mode or
  122. RTL, read logcat and the app's database. The agent can build a screen, run it, look at the result, and
  123. fix it by itself.
  124. <p align="center">
  125. <img src="docs/ai-agents.jpg" width="500" alt="AI Agents settings: Off, Read only or Full control, and the setup command for each agent">
  126. </p>
  127. <p align="center">
  128. <a href="https://cursor.com/en/install-mcp?name=oh-my-android&config=eyJjb21tYW5kIjoiL29wdC9ob21lYnJldy9iaW4vb2hteWFuZHJvaWQtbWNwIn0="><img src="https://cursor.com/deeplink/mcp-install-dark.svg" height="32" alt="Add Oh My Android MCP server to Cursor"></a>
  129. <a href="https://insiders.vscode.dev/redirect/mcp/install?name=oh-my-android&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22%2Fopt%2Fhomebrew%2Fbin%2Fohmyandroid-mcp%22%7D"><img src="https://img.shields.io/badge/VS_Code-Install_MCP_server-0098FF?logo=visualstudiocode&logoColor=white" height="32" alt="Install Oh My Android MCP server in VS Code"></a>
  130. </p>
  131. The buttons use the Homebrew path `/opt/homebrew/bin/ohmyandroid-mcp`. With the zip install, use the menu bar setup below.
  132. **Set up in one step:** menu bar icon → **AI Agents → Set Up…**, choose your agent, click **Copy**
  133. (or **Add to Cursor** / **Add to VS Code**). Or by hand:
  134. ```sh
  135. claude mcp add --scope user oh-my-android -- ohmyandroid-mcp # Claude Code
  136. codex mcp add oh-my-android -- ohmyandroid-mcp # Codex CLI
  137. gemini mcp add --scope user oh-my-android ohmyandroid-mcp # Gemini CLI
  138. ```
  139. ```json
  140. { "mcpServers": { "oh-my-android": { "command": "/Applications/Oh My Android.app/Contents/MacOS/ohmyandroid-mcp" } } }
  141. ```
  142. The JSON works in Cursor, Claude Desktop, Windsurf, Gemini CLI and other agents (VS Code uses `"servers"`).
  143. Homebrew puts `ohmyandroid-mcp` on your `PATH`. With the zip install, use the full path above.
  144. Other ways to add it:
  145. - **Claude Code plugin:** `/plugin marketplace add ateymoori/oh-my-android`, then `/plugin install oh-my-android@oh-my-android`
  146. - **Claude Desktop extension:** open `oh-my-android-<version>.mcpb` from the [latest release](https://github.com/ateymoori/oh-my-android/releases/latest)
  147. - **MCP Registry:** listed as `io.github.ateymoori/oh-my-android`
  148. **You stay in control:** menu bar icon → **AI Agents** → *Off*, *Read only* or *Full control*. The server
  149. checks it on every call, so a change applies at once. Tools that can lose data are marked destructive,
  150. so your agent asks you first.
  151. | Group | Tools |
  152. |---|---|
  153. | See | `screenshot` (scaled to 1 px = 1 dp) · `get_ui` (compact UI tree with refs) · `accessibility_audit` |
  154. | Act | `tap` (by ref, text or x,y) · `swipe` · `type_text` · `press_key` |
  155. | Device | `list_devices` · `get_device_state` · `set_device_settings`: dark mode, font scale, display size, locale / RTL, orientation, TalkBack, animations, Wi‑Fi, airplane mode, network speed, GPS, battery |
  156. | Apps | `list_apps` · `open_app` (package or deep link, reports cold start time) · `manage_app` · `install_apk` · `logcat` |
  157. | Data | `read_preferences` · `query_database` (read-only SQL on a copy) |
  158. | Emulator | `emulator_action`: fingerprint, incoming call, SMS, save / load snapshot |
  159. Ready-made prompts: `accessibility_review`, `ui_matrix` (dark mode, large fonts, RTL, pseudo-locales)
  160. and `debug_crash`.
  161. **Try asking your agent:**
  162. - *"Take a screenshot of the emulator and check this screen in dark mode."*
  163. - *"Open the app, go to Settings, and check it in dark mode, font scale 2 and Arabic. Fix what breaks."*
  164. - *"The app crashes when I tap Save. Reproduce it, read the crash, and fix it."*
  165. - *"Audit the login screen for TalkBack and fix the problems in the code."*
  166. **Built for models:** every position is in dp, like your layout code. Output is compact text: a UI tree
  167. is about 10× smaller than the raw `uiautomator` XML, and all 18 tool definitions fit in under 4k tokens
  168. (the `tools/list` reply is about 14.5 KB).
  169. The server supports MCP 2026-07-28 and the earlier versions (2024-11-05 to 2025-11-25) over stdio,
  170. has no dependencies, and needs no network.
  171. ## Privacy and security
  172. - **No analytics, no telemetry, no account.** The only network request of its own is the update
  173. check: once a day it reads a small feed from this repo's GitHub releases. It sends nothing about you or
  174. your devices. Turn it off in **Settings → Updates**.
  175. - Updates ([Sparkle](https://sparkle-project.org)) install only when you choose, and only if they are
  176. signed with this project's EdDSA key and the same Developer ID.
  177. - Talks only to the `adb` of your own Android SDK. Text you type is shell-quoted before it reaches the device.
  178. - Database copies from the Data Inspector are deleted when you reload and when the app quits.
  179. - The MCP server runs only when your AI agent starts it, and only with the access you allow. What it
  180. reads (screen, UI, logs, app data) goes to your agent, and from there to the agent's model provider.
  181. - Signed with a Developer ID, hardened runtime, notarized by Apple.
  182. Found a vulnerability? See [SECURITY.md](SECURITY.md).
  183. ## Troubleshooting
  184. - **adb not found:** pick your SDK in **Settings → Android SDK**, or set `ANDROID_HOME`.
  185. - **The agent says there is no device:** start an emulator or connect a phone, then ask the agent to run `list_devices`.
  186. - **Agent cannot start `ohmyandroid-mcp` (zip install):** only Homebrew puts it on your `PATH`. Use the full path
  187. `/Applications/Oh My Android.app/Contents/MacOS/ohmyandroid-mcp`.
  188. - **Homebrew says the tap is not trusted:** Homebrew 6 and later ask you to trust third-party taps. The full
  189. `brew install --cask ateymoori/tap/oh-my-android` trusts only this cask. For short names, run
  190. `brew trust --cask ateymoori/tap/oh-my-android` first.
  191. - **The agent gets "Access is Off":** menu bar icon → **AI Agents** → *Read only* or *Full control*.
  192. ## FAQ
  193. <details>
  194. <summary><b>Is Oh My Android free?</b></summary>
  195. Yes. It is free and open source under the MIT license.
  196. </details>
  197. <details>
  198. <summary><b>Does it replace the Android Emulator or Android Studio?</b></summary>
  199. No. It is a companion. It controls Google's emulator and your phones through the Android SDK you
  200. already have. It bundles no emulator and no SDK.
  201. </details>
  202. <details>
  203. <summary><b>Does it work with a real Android phone?</b></summary>
  204. Yes, over USB or Wi‑Fi `adb`. Only the emulator-only blocks (GPS, battery, calls, SMS, snapshots,
  205. network speed, screen recording) need an emulator.
  206. </details>
  207. <details>
  208. <summary><b>Does it work with Jetpack Compose?</b></summary>
  209. Yes. The Layout Inspector and the accessibility audit read the Compose semantics tree through
  210. `uiautomator`, the same as for Views.
  211. </details>
  212. <details>
  213. <summary><b>Which AI agents work with it?</b></summary>
  214. Any agent that supports MCP over stdio: Claude Code, Claude Desktop, Codex CLI, Cursor, VS Code
  215. (GitHub Copilot), Windsurf, Gemini CLI, JetBrains AI, Zed and more. The app does not have to be open;
  216. the agent starts the server when it needs it.
  217. </details>
  218. <details>
  219. <summary><b>How do I turn on dark mode on the Android Emulator?</b></summary>
  220. Click the moon icon in the panel. The adb way is `adb shell cmd uimode night yes` (and `no` to turn it off).
  221. </details>
  222. <details>
  223. <summary><b>How do I test RTL layouts on the Android Emulator?</b></summary>
  224. Pick "العربية (RTL)" or another RTL language from the language menu, or a pseudo-locale (`ar-XB`, `en-XA`) to
  225. find hard-coded strings and mirroring bugs. The adb way is `adb shell cmd locale set-device-locale ar-EG`.
  226. </details>
  227. <details>
  228. <summary><b>How do I simulate a slow network on the Android Emulator?</b></summary>
  229. Pick a profile (LTE, HSDPA, 3G, EDGE, GPRS, GSM) from the network menu. The panel sets both speed and
  230. latency, the same as `adb emu network speed edge` and `adb emu network delay edge`.
  231. </details>
  232. <details>
  233. <summary><b>Is there an Android MCP server for Claude Code, Codex or Cursor?</b></summary>
  234. Yes. `ohmyandroid-mcp` ships inside the app. Your agent can take screenshots in dp, read the UI tree, tap,
  235. type, switch dark mode, font size or RTL, and read logcat. See [AI agents (MCP)](#ai-agents-mcp).
  236. </details>
  237. <details>
  238. <summary><b>Is there an npx or uvx package?</b></summary>
  239. No. The server is one native binary with no runtime; Homebrew puts `ohmyandroid-mcp` on your `PATH`.
  240. </details>
  241. <details>
  242. <summary><b>Windows or Linux?</b></summary>
  243. Not now. It is a native macOS app built with SwiftUI.
  244. </details>
  245. <details>
  246. <summary><b>Why is it not in the Mac App Store?</b></summary>
  247. Mac App Store apps must run in the App Sandbox, and a sandboxed app cannot start `adb`.
  248. Homebrew and GitHub releases are signed and notarized by Apple instead.
  249. </details>
  250. <details>
  251. <summary><b>Why macOS 26 or later?</b></summary>
  252. The panel uses Liquid Glass and other APIs that are new in macOS 26 Tahoe.
  253. </details>
  254. <details>
  255. <summary><b>How is it built? Did AI write it?</b></summary>
  256. It is a SwiftUI and AppKit app in Swift 6 with strict concurrency, about 6,800 lines, and one
  257. dependency (Sparkle, for updates). Most commits are co-authored with Claude Code, as the history shows.
  258. CI builds the app with warnings treated as errors and runs the MCP protocol test (`Scripts/test-mcp.py`)
  259. on every push and pull request.
  260. </details>
  261. ## Build from source
  262. ```sh
  263. brew install xcodegen
  264. git clone https://github.com/ateymoori/oh-my-android.git && cd oh-my-android
  265. xcodegen generate
  266. open OhMyAndroid.xcodeproj
  267. ```
  268. Needs Xcode 26. Local builds are ad-hoc signed, so you need no Apple Developer account.
  269. <details>
  270. <summary><b>Architecture</b></summary>
  271. ```
  272. Sources/
  273. App/ entry point, AppDelegate (host actions), Settings, assets
  274. Core/ no UI, no feature knowledge
  275. Shell/ ShellRunning: non-blocking Process runner, stopped on timeout or cancellation
  276. Android/ AndroidSDK, ADBClient, DeviceTracker (adb track-devices), UI hierarchy, app data
  277. SQLite/, Imaging/
  278. Features/ one small type per capability, registered in FeatureCatalog (Foundation only)
  279. MCP/ ohmyandroid-mcp: stdio MCP server built on Core and Features, shipped inside the app
  280. State/ AppModel (composition root), DeviceStore, FeatureStore, inspector stores
  281. Windows/ FloatingPanel, emulator window docking, tool windows
  282. UI/ SwiftUI; FeatureCell renders any feature from its protocol
  283. ```
  284. Dependencies point one way: `UI → State → Features → Core`. Features talk to the device through the
  285. `ADBClient` protocol and to the Mac through `HostActions` (file picker, clipboard, Finder), so each one
  286. is a small value type. Swift 6 language mode, strict concurrency, zero warnings.
  287. | Protocol | Control | Example |
  288. |---|---|---|
  289. | `ToggleFeature` | on/off icon | Dark mode, TalkBack, Wi‑Fi |
  290. | `BatchReadable` (add-on) | state read in one shared `adb shell` round-trip | every `settings` / `getprop` feature |
  291. | `StepperFeature` | popover with − / + | Font size, Display size |
  292. | `ChoiceFeature` | menu | Language, Network speed, Battery |
  293. | `ActionFeature` | one tap | Screenshot, Rotate, Force stop |
  294. | `TextActionFeature` | popover with a text field | Deep link, Type text, SMS |
  295. **Energy:** nothing polls. Device changes come from adb's `track-devices` stream. Feature values are
  296. read in one batched `adb shell` call when you select a device, after an action, and when the pointer
  297. comes back to the panel. Docking uses a 1 Hz timer only while an emulator runs and the panel is visible.
  298. The app and menu bar icons are drawn in code: `Scripts/make-icon.swift`.
  299. </details>
  300. ## Roadmap
  301. - Compare mode: two devices side by side, mirrored input, pixel diff
  302. - The emulator screen embedded in the panel window
  303. - DataStore (`.preferences_pb`) support in the Data Inspector
  304. - MCP: start and stop emulators, record the screen
  305. Have an idea? [Open a feature request](https://github.com/ateymoori/oh-my-android/issues/new/choose).
  306. Adding a feature is one small Swift struct: see [CONTRIBUTING.md](CONTRIBUTING.md).
  307. ---
  308. <p align="center">
  309. If Oh My Android saves you time, a star helps other Android developers find it.<br>
  310. To get a notification for every new version, click <b>Watch → Custom → Releases</b>.
  311. </p>
  312. ## License
  313. [MIT](LICENSE) © 2026 [Royan AB](https://royan.se).
  314. Android is a trademark of Google LLC. Oh My Android is not affiliated with or endorsed by Google.
  315. The Android robot is reproduced or modified from work created and shared by Google and used according
  316. to terms described in the [Creative Commons 3.0 Attribution License](https://creativecommons.org/licenses/by/3.0/).
  317. ---
  318. <p align="center">
  319. Made in Sweden by 🇸🇪 <a href="https://royan.se"><b>Royan AB</b></a><br>
  320. <a href="https://royan.se/work/oh-my-android/">Oh My Android website</a> · <a href="https://royan.se">royan.se</a>
  321. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.