emulator

README

emu

A small yet handy CLI program to make working with Android emulators a bit more pleasant.

Windows isn't currently supported.

Install

macOS

brew tap bartekpacia/tools
brew install emu

ArchLinux

TBD

Features

• Easily list and run emulators
• Full shell completion for all commands, flags, and emulator names
• Change font size and display size
• Toggle dark mode
• bonus: doesn't butcher your AirPods sound quality!

Documentation

Overview

Package emulator provides common functionality to manage Android emulators.

Index

• Variables
• func DisableAnimations() error
• func DisableDarkTheme() error
• func EnableAnimations() error
• func EnableDarkTheme() error
• func SetDisplaySize(value float32) error
• func SetFontSize(value string) error
• func Start(name string) error
• func ToggleAnimations() error
• func ToggleDarkTheme() error
• type AVD
  • func List() ([]AVD, error)
  • func (a AVD) Describe() string

Variables

var PrintInvocations bool

PrintInvocations controls whether to print invocations of subprocesses.

var Serial string

Serial is the serial port of the running AVD, for example "emulator-5554".

Functions

func DisableAnimations

func DisableAnimations() error

func DisableDarkTheme

func DisableDarkTheme() error

func EnableAnimations

func EnableAnimations() error

func EnableDarkTheme

func EnableDarkTheme() error

func SetDisplaySize

func SetDisplaySize(value float32) error

func SetFontSize

func SetFontSize(value string) error

func Start

func Start(name string) error

Start starts the AVD with the given name.

func ToggleAnimations

func ToggleAnimations() error

func ToggleDarkTheme

func ToggleDarkTheme() error

Types

type AVD

type AVD struct {
	Name    string
	Running bool

	// PID of the emulator process. Equals 0 if Running is false.
	Pid int
}

AVD represents an Android Virtual Device.

It assumes that no 2 instances of the same AVD run at the same time.

func List

func List() ([]AVD, error)

List returns a list of available AVDs and whether they're running or not.

func (AVD) Describe

func (a AVD) Describe() string