ae - Android Emulator Launcher

A fast, interactive CLI for launching Android emulators. No configuration required.

Features

• Interactive Selection: Arrow keys to navigate, Enter to launch
• Auto-Discovery: Finds your Android SDK automatically
• Zero Config: Works out of the box with standard Android Studio setup
• Fast: Standalone binary with no runtime dependencies

Installation

Quick Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/fazulk/ae/main/install.sh | bash

Manual Download

Download the appropriate binary for your system:

macOS

Architecture	Download
Apple Silicon (M1/M2/M3)	ae-darwin-arm64
Intel	ae-darwin-x64

Linux

Architecture	Download
x64	ae-linux-x64
ARM64	ae-linux-arm64

Then:

# Move to a directory in your PATH
mv ae-darwin-* ~/.local/bin/ae

# Make executable
chmod +x ~/.local/bin/ae

# Verify installation
ae --version

Usage

# Interactive emulator selection
ae

# Show help
ae --help

# Show version
ae --version

Requirements

• macOS (Apple Silicon or Intel) or Linux (x64 or ARM64)
• Android SDK with at least one AVD configured
• Android Studio recommended (sets up SDK automatically)

How It Works

1. Searches for Android emulator in standard locations:

   • $ANDROID_HOME/emulator/emulator
   • $ANDROID_SDK_ROOT/emulator/emulator
   • macOS: ~/Library/Android/sdk/emulator/emulator
   • Linux: ~/Android/Sdk/emulator/emulator

2. Lists available AVDs using emulator -list-avds

3. Presents interactive selection UI

4. Launches selected emulator in the background

Building from Source

Requires Bun installed.

# Clone the repository
git clone https://github.com/fazulk/ae.git
cd ae

# Install dependencies
bun install

# Run directly
bun run start

# Build for current architecture
bun run build

# Build for all architectures (macOS + Linux)
bun run build:all

License

MIT