Skip to main content
YumeBox

​
What it does

YumeBox is an Android client for mihomo. It manages subscriptions, local profiles, and overrides, compiles the effective configuration, and runs mihomo with views for proxies, connections, traffic, and logs.

​
How it works

  1. Import a subscription or a local YAML profile and choose the active profile.
  2. Optionally bind YAML or JavaScript overrides.
  3. Start VPN, Root TUN, or transparent proxy mode.
  4. While mihomo is running, YumeBox exposes live proxy, rule, connection, and traffic data. Those runtime views disappear when the proxy stops.
YumeBox does not edit the subscription source file. Provider files are kept in the active profile’s private directory so profiles cannot overwrite each other.

​
Start here

App guide

Learn about modes, providers, and common settings.

Overrides

Layer local YAML or JavaScript onto a subscription.

Build guide

Prepare native dependencies and build an APK.

​
Download and feedback

Download

Get an APK from GitHub Releases.

Report an issue

Include reproduction steps, logs, and device details.

mihomo configuration reference

mihomo maintains the full reference for configuration fields, rules, and providers.
Last modified on July 20, 2026