Skip to main content

app_locale · set_app_locale

This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET

Read or set the language one app runs in. These call app_locale.

app_locale​

def app_locale(app: str) -> list[str]

Language tags pinned for an app; empty means it follows the device.

set_app_locale​

def set_app_locale(app: str, *tags: str) -> list[str]

Run one app in a chosen language; no tags follows the device again.

Android 13 and later. What this confirms is that the device stored the tag, not that the app has a translation for it — Android reports no difference — so check the screen. Relaunch the app to re-render it.

Examples​

Run one app in Japanese​

device.set_app_locale("org.wikipedia", "ja-JP")

The same call from the command line, mobium locale org.wikipedia ja-JP, printed on an Android 15 emulator:

org.wikipedia set to ja-JP — the device stored it; whether org.wikipedia has that translation is not something Android reports, so check the screen

On a device​

mobium launch org.wikipedia on an Android 15 emulator

mobium launch org.wikipedia on an Android 15 emulator