English · 简体中文
Moke is a native SSH / mosh terminal for Android. It connects to remote servers directly inside the app — run a shell, tmux, vim, or a full-screen TUI such as Claude Code — and reuses termux's terminal-view / terminal-emulator (Apache-2.0) for terminal rendering instead of writing its own ANSI parser.
- SSH: password / private-key (PEM) auth; TOFU host-key verification with fingerprint confirmation on first connection; jump host (ProxyJump); per-host startup command (e.g. pick cmd, PowerShell or WSL on a Windows host); run-on-login command; keep-alive heartbeat.
- mosh: bundled native
mosh-clientrunning as a separate subprocess over a PTY; UDP roaming (survives screen-off and network switches); closing a session also shuts down the remotemosh-server. - tmux: a panel to attach / create / rename / detach / kill remote sessions; optionally attach automatically on connect; optionally let tmux handle swipe scrolling.
- Files: browse remote folders over SFTP (SSH and mosh hosts); upload / download with resume; transfers keep running in the background; send a file's path to the terminal.
- Sessions & hosts: multiple sessions stay resident, with a foreground service keeping connections alive in the background; group / sort (including manual drag-to-reorder); duplicate; per-session titles; clear ended sessions; copy connect command.
- Terminal: two-row extra keys plus an expandable full keyboard (editing keys, F1–F12, Ctrl shortcuts) with lockable modifiers; text-block input; three keyboard modes (character / standard / IME first) for comfortable CJK input; copy & paste, including remote clipboard writes (OSC 52); pinch-to-zoom; swipe-to-scroll in full-screen TUIs with a selectable mode, plus jump-to-latest; a top status bar (protocol / host / latency).
- Appearance: live preview; light / dark / follow-system theme with separate terminal color schemes for each; font size / line spacing / letter spacing; cursor style; font management (primary + CJK fallback — a bundled Noto Sans SC subset, plus downloadable Fira Code / Maple Mono / Hack and more, or import your own).
- Security, languages & updates: credentials are encrypted with the Android Keystore (AES-GCM) before being stored and are excluded from system backups; bilingual English / 中文, following the system language by default and switchable in Settings; in-app update check (optionally including pre-releases).
Hosts · Terminal (Claude Code over SSH) · tmux panel · Remote files · Appearance (light theme)
From Releases, pick one:
moke-vX.Y.Z.apk— standard build; CJK fallback is a bundled Noto Sans SC subset (smaller).moke-vX.Y.Z-maple.apk— bundles Maple Mono as the default CJK fallback, monospaced CJK out of the box (larger).
Allow "install from unknown sources" and install. Release builds use a stable signature, so upgrades install over the top.
| Module | Description | License |
|---|---|---|
app |
Product layer (Compose UI / session orchestration / transport implementations) | GPL-3.0-or-later |
terminal-emulator |
Terminal parsing / state core (vendored; TerminalSession made transport-agnostic; the PTY JNI is kept for the mosh subprocess) |
Apache-2.0 |
terminal-view |
Terminal rendering View (vendored; additive changes for line / letter spacing and swipe scrolling) | Apache-2.0 |
Requires JDK 17 + Android SDK (compileSdk 35 / build-tools 35). Create local.properties at the project root pointing to the SDK: sdk.dir=/path/to/Android/sdk.
./gradlew assembleStandardDebug # standard debug APK
./gradlew testDebugUnitTest # unit tests
# The `maple` flavor bundles Maple Mono as the default CJK fallback.
# Fetch the font first (OFL, ~20 MB, not checked in), then build:
./scripts/fetch-maple-font.sh && ./gradlew assembleMapleDebugThe mosh native artifacts are reproducibly built by scripts/build-mosh-native.sh from public sources (mosh 1.4.0 + rjyo/mosh-android prebuilt libs); NDK r29 is required, and the GPLv3 binaries are not checked in. The maple flavor's bundled font is fetched by scripts/fetch-maple-font.sh (OFL, not checked in).
Only issue-based reports are accepted; pull requests are not accepted for now (see CONTRIBUTING).
Community discussion: 学AI，linuxdo
The terminal core reuses terminal-emulator / terminal-view from termux/termux-app (Apache-2.0, originally from Android Terminal Emulator). SSH transport uses sshj. The mosh native component is based on mobile-shell/mosh (GPLv3) and rjyo/mosh-android. The bundled Chinese font is a subset of Noto Sans SC (OFL). See THIRD_PARTY_NOTICES.md for the full list.
The moke product layer (app/) is released under the GNU General Public License v3.0 or later; see LICENSE and COPYRIGHT.md. The vendored terminal-* modules are Apache-2.0 (GPLv3-compatible); the mosh native component is GPLv3 and ships as a standalone executable.