Skip to main content

appLocale

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.

appLocale​

public List<String> appLocale(String app)
public List<String> appLocale(String app, String tags)

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

@param app the package name (Android) or bundle id (iOS) @return the tags now pinned; empty when the app follows the device

Runs one app in a chosen language; an empty tag 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 for it to re-render.

@param app the package name (Android) or bundle id (iOS) @param tags language tags such as "ja-JP", or empty to follow the device @return the tags now pinned; empty when the app follows the device

Examples​

Run one app in Japanese​

List<String> pinned = device.appLocale("org.wikipedia", "ja-JP");   // [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