Skip to content

Settings

Jump to bottom
ars edited this page Mar 24, 2026 · 24 revisions

Application Settings

This page provides a detailed explanation of all configuration options in Headunit Revived.

General Settings

Auto-Optimization Wizard (v2.0.0+)

Scans your hardware and recommends the best settings for Resolution, DPI, and Codec.

  • Recommendation: Use this tool first if you experience a black screen or if UI elements look too small/large.

Language

Select your preferred UI language. The app supports 13+ languages. Changes are applied instantly.

Night Mode

  • Auto (Time): Sunset/Sunrise calculated based on last known location.
  • Auto (Time + GPS): Waits for a fresh GPS lock for precise time calculation.
  • Light Sensor: Uses the device's physical ambient light sensor.
  • Screen Brightness: Switches based on system display brightness (useful for headunits that dim with headlights).

Wireless Mode

  • Helper Mode (Recommended): Tablet waits for a trigger from the Wireless Helper app. Supports Wi-Fi Direct (P2P).
  • Auto-Scan: Tablet actively searches for phones running an AA Headunit Server (Port 5277).

Auto-Start & Connectivity

  • Auto-Start on Bluetooth: Automatically opens the app when a specific Bluetooth device is connected.
  • Auto-Connect Priority: Reorder connection methods (Last Session, USB, Self-Mode) via drag-and-drop.
  • Auto-Connect Single USB: Automatically connects if only one compatible USB device is found.
  • Exit on Disconnect (v2.1.0+): Gracefully closes the app and background service when the phone is disconnected.

Navigation & System Integration

GPS for Navigation

If enabled, the tablet's GPS data is shared with the phone to improve accuracy and save phone battery.

Navigation Provider

Headunit Revived registers as a system-wide navigation app. This allows vehicle systems (like BMW iDrive) to recognize it and display directions in instrument clusters or HUDs (if supported).

Graphic & Video Settings

Screen Mode

  • Normal: Status and navigation bars are always visible.
  • Immersive: Both bars are hidden.
  • Hide Status Bar Only: Recommended if hardware buttons overlap with the view.

Stretch to Fill (v2.1.0+)

Forces the video projection to fill the entire available screen area, ignoring the original aspect ratio. Requires a session restart.

Custom Insets (Margins)

Manually adjust Top, Bottom, Left, Right margins. Crucial for buggy headunits where system bars overlay the app buttons.

Resolution & DPI

  • Resolution: 480p up to 1440p (H.265 required for 1440p).
  • DPI: Controls the size of icons/text. Set to 0 for Auto.

Video Codec & Performance

  • Codec: H.264 (Standard) or H.265 (Better quality).
  • H.265 Optimization (v2.1.0+): Features 4MB buffers and VPS/SPS/PPS parsing to eliminate artifacts on 4K-capable hardware.
  • FPS Limit: Toggle between 30 FPS (stable) and 60 FPS (smooth).
  • View Mode: TextureView (Default), SurfaceView (Efficient), or GLES20 (Legacy).

Audio & Input Settings

Audio Sink

If enabled, audio plays through the headunit. If disabled, audio stays on the phone.

Audio Volume Offsets

Separate volume gain controls (0% to 200%) for Media, Assistant, and Navigation streams.

Microphone Input

  • Input Source: Default, Microphone, Voice Recognition, or Voice Communication (Recommended for Echo Cancellation).
  • Sample Rate: 16kHz up to 48kHz.
  • Use AAC Audio: (Experimental) Uses compressed audio to save WiFi bandwidth.

Keymap

Map physical keys (steering wheel, knobs) to AA functions.

  • BMW iDrive Fix (v2.1.0+): ENTER is automatically mapped to DPAD_CENTER for full compatibility.

Debugging

Logging

  • Log Level: Adjust verbosity (Info, Debug, Verbose).
  • Export Logs: Save logs to a public folder to share with developers.

Use Native SSL

Uses native OpenSSL for significantly better performance on older chipsets. Mandatory for Android 15+.

Clone this wiki locally