Configuration

Settings storage

Emu persists all settings in a local SQLite database. You can access settings from the Settings tab in the GUI.

Platform	Database path
macOS	~/Library/Application Support/emu/emu.db
Linux	~/.local/share/emu/emu.db
Windows	%APPDATA%\emu\emu.db

GPU mode

Controls how the emulator renders graphics. Configurable per-AVD in the device wizard and settings.

• Host: Uses your system’s GPU for hardware-accelerated rendering. Default and recommended.
• Software: CPU-based rendering. Use if you encounter graphical glitches or lack a compatible GPU.

Mirror backend

Emu automatically selects the mirroring backend based on device type and host capabilities — emulators use an optimized shared-memory path when available, physical devices use the scrcpy protocol, and the system falls back through hardware decode options (H.265/H.264 Vulkan, platform hardware decode, software decode) as needed.

You can manually override the backend in Settings > Mirroring.

MCP port

The MCP server listens on port 8565 by default. Change it in the settings panel or via the CLI:

emu mcp --port 9000

Tiling window managers

The mirror popout window works best when configured to float. Emu sets the app_id to emu-live on Wayland.

Hyprland

Add to ~/.config/hypr/hyprland.conf and run hyprctl reload:

windowrule = match:class emu-live, float on
windowrule = match:class emu-screenshot, float on