Skip to content
ArnabXDPublic

About

List & Launch Android/iOS Emulator/Simulator

Resources

Stars

5 stars

Watchers

0 watching

Forks

Latest commit

 

History

32 Commits

Folders and files

Repository files navigation

emulaunch

Interactive TUI for listing and launching Android emulators and iOS simulators.

asciicast

Installation

Shell (macOS/Linux)

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/ArnabXD/emulaunch/releases/latest/download/emulaunch-installer.sh | sh

PowerShell (Windows)

powershell -ExecutionPolicy Bypass -c "irm https://github.com/ArnabXD/emulaunch/releases/latest/download/emulaunch-installer.ps1 | iex"

Prebuilt Binaries

Download from the latest release page.

Supported platforms:

  • macOS (Intel x86_64 and Apple Silicon aarch64)
  • Linux (x86_64 and ARM64)
  • Windows (x86_64) — includes MSI installer

From Source

cargo install --path .

Usage

# Launch interactive TUI picker
emulaunch

# Print plain text list
emulaunch list

# Open a specific emulator by name
emulaunch open <name>

TUI Keybindings

Key Action
j / k / arrows Navigate
Enter Open selected emulator
q / Esc Quit
Type any text Filter list
Backspace Clear filter

Configuration

emulaunch looks for a TOML config file at:

  1. ~/.config/emulaunch/config.toml
  2. ~/.emulaunch/config.toml (fallback)
# Command paths (optional — auto-detected by default)
android_emulator_cmd = "emulator"
adb_cmd = "adb"
xcrun_cmd = "xcrun"  # macOS only

# Theme (optional — defaults to "default")
# Available: default, catppuccin-mocha, catppuccin-latte, dracula, tokyo-night, gruvbox-dark, nord
theme = "catppuccin-mocha"

# Per-slot color overrides using hex values (optional)
[theme_overrides]
selection_bg = "#313244"

If no config file exists, environment variables are used as fallback:

export ANDROID_EMULATOR_CMD="emulator"
export ADB_CMD="adb"
export XCRUN_CMD="xcrun"  # macOS only

Themes

Theme Style
default Classic terminal colors
catppuccin-mocha Dark pastel
catppuccin-latte Light pastel
dracula Dark purple/pink
tokyo-night Blue-heavy dark
gruvbox-dark Warm amber retro
nord Cool blue-gray

All theme colors use true-color RGB values for consistent rendering across terminals. Individual color slots can be overridden via [theme_overrides] using #rrggbb hex values. Available slots: header_fg, name_fg, state_booted_fg, state_shutdown_fg, state_unknown_fg, meta_fg, filter_placeholder_fg, filter_active_fg, selection_bg, help_key_fg, help_text_fg.

Requirements

  • Rust via rustup
  • macOS for iOS simulator support
  • Android SDK for Android emulators

License

MIT

About

List & Launch Android/iOS Emulator/Simulator

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages