Skip to content

Settings

Jump to bottom
ars edited this page Mar 24, 2026 · 15 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 display to automatically recommend the optimal Resolution, DPI, and Video 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.

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-Connect Priority: Reorder connection methods via drag-and-drop and enable/disable them individually:
    • Last Session: Automatically reconnects to the last used device (USB or WiFi).
    • Self-Mode: Launches local Android Auto simulation.
    • Single USB: Automatically connects if only one compatible USB device is found.
  • Auto-Start on Bluetooth: Automatically opens the app when a specific Bluetooth device is connected.
  • Exit on Disconnect (v2.1.0+): Gracefully closes the app and service when the phone is disconnected.

Dark Mode & UI Themes

Application Theme (UI)

Choose how the app interface itself looks:

  • Clear / Dark / Extreme Dark: Static themes.
  • Auto (Time / GPS): Switches based on sunrise/sunset.
  • Light Sensor / Screen Brightness: Switches based on hardware ambient light or system brightness. Includes a configurable Threshold Slider.
  • Manual Time: Set specific hours for the theme switch.

Visual Options

  • Monochrome Icons: Switches app icons to a simplified black/white style.
  • Extreme Dark Mode: Forces a pitch-black background (OLED friendly) for auto modes.
  • Gradient Background: Enables a subtle gradient effect on menus (Disabled in Extreme Dark).

Android Auto Night Mode

Controls the theme of the projected Android Auto interface:

  • Same modes as App Theme: (Auto, Sensor, Brightness, Manual Time).
  • AA Monochrome (v2.0.0+): Desaturates colors during night mode to reduce glare. Features a Desaturation Level slider (0% to 100%).

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