avds

README

avds - Android Virtual Device Launcher

Run Android emulator background from console.

A lightweight command-line tool for managing Android emulators with interactive selection and background launching.

Features

• 🚀 Fast and lightweight command-line interface
• 🔍 Interactive device selection using arrow keys
• 🏃‍♂️ Background emulator launching
• 🌈 Cross-platform support (Windows, macOS, Linux)
• 🔧 Simple installation and usage

Requirements

• Android SDK installed
• ANDROID_HOME or ANDROID_SDK_ROOT environment variable set
• At least one AVD created via AVD Manager

Installation

Using Go (all platforms)

go install github.com/aitsuki/avds@latest

Linux/macOS

curl -sfL https://raw.githubusercontent.com/aitsuki/avds/main/install.sh | sh

Windows

iwr -useb https://raw.githubusercontent.com/aitsuki/avds/main/install.ps1 | iex

Manual Installation

Download the latest binary from GitHub Releases.

Usage

1. Run avds to list available devices
2. Select AVD using arrow keys
3. Press Enter to launch in background

Troubleshooting

Emulator not found

Ensure ANDROID_SDK_ROOT or ANDROID_HOME is correctly set and emulator is in PATH.

List is empty

Create an AVD using Android Studio's AVD Manager first.

Permission denied

Make sure the downloaded binary has execute permission:

chmod +x path/to/avds

Uninstallation

Linux/macOS

curl -sfL https://raw.githubusercontent.com/aitsuki/avds/main/uninstall.sh | sh

Windows

iwr -useb https://raw.githubusercontent.com/aitsuki/avds/main/uninstall.ps1 | iex

License

This project is licensed under the MIT License - see the LICENSE file for details.