Skip to content

Settings

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

Application Settings

This page describes the various configuration options available in the HeadUnit Revived application.

General Settings

  • Language (New in 1.13.3)

    • Options: System Default, English, German, Spanish, etc.
    • Description: Manually select the application language. Changes are applied instantly across the entire app.

  • Night Mode

    • Options: Auto (Time), Day, Night, Auto (Time + GPS), Light Sensor, Screen Brightness
    • Description: Controls the day/night theme of the Android Auto projection.

  • Wireless Mode (Updated in 1.12.0)

    • Options: Manual, Auto-Scan, Helper Mode
    • Description: Defines how the app handles wireless connections.

  • GPS for Navigation

    • Type: Toggle
    • Description: If enabled, the head unit's GPS data is shared with the phone.

  • Auto-Start on Bluetooth (New in 1.14.0)

    • Type: Toggle
    • Description: Automatically opens the app when a specific Bluetooth device (e.g., your car's headunit) is connected.

  • Auto-Connect Priority (New in 1.15.0)

    • Description: Opens a screen where you can enable/disable and reorder automatic connection methods (e.g., Last Session, USB, Self-Mode) via drag-and-drop. The app will try each method in the specified order.

  • USB Stability Check (New in 1.15.0)

    • Type: Toggle
    • Description: Useful for wireless adapters that might disconnect/reconnect briefly during initial handshake. Includes a configurable Stability Timeout (default 10s).

  • Max Reconnect Attempts (New in 1.15.0)

    • Options: 1 to 10
    • Description: Number of times the app will automatically try to restart a failed session.

  • Keymap (Updated in 1.14.1)

    • Description: Opens the Keymap configuration screen where you can map physical keys (like steering wheel buttons) to Android Auto functions. Features an enhanced Key-Sniffer that logs all key events, special characters (ö, ü, ß), and proprietary steering wheel intents (MTC, FYT) directly in the UI for easier troubleshooting.

Graphic Settings

  • Resolution

    • Options: Auto, 480p, 720p, 1080p, 1440p
    • Note: 1440p requires API 24+ and H.265 support.

  • DPI

    • Input: Numeric Value (Enter 0 for Auto)
    • Description: Sets the screen density. Set to 0 for automatic detection. Lower values make UI elements larger.

  • Custom Insets (Margins) (New in 1.13.0)

    • Description: Allows manual adjustment of screen margins (Top, Bottom, Left, Right). Useful for correcting overscan issues on certain headunits or AI-Boxes. Features a live preview directly in the settings UI.

  • Start in Fullscreen Mode

    • Type: Toggle
    • Description: If enabled, hides the Android status and navigation bars during projection.

  • View Mode

    • Options: SurfaceView, TextureView, GLES20
    • Description: SurfaceView is usually the most efficient. Use GLES20 only for very old hardware.

Audio Settings

  • Audio Sink
    • Type: Toggle
    • Description: Enables audio playback on the headunit. If disabled, sound will play from the phone.
  • Audio Volume Offsets (New in 1.14.0)
    • Description: Provides separate volume gain controls for Media, Assistant, and Navigation streams. Accessible via a consolidated dialog with vertical sliders (0% to 200%).

System Integration (New in 1.15.0)

  • Navigation Provider: Headunit Revived now registers as a system-wide navigation app (category: maps). This allows it to be recognized by vehicle systems (like BMW) and shown in native menus or instrument clusters if supported.
  • Navigate Intents: Supports standard NAVIGATE intents from Google Maps or other apps.

Graphic Settings

  • Microphone Input Source (New in 1.13.2)

    • Options: Default, Microphone, Voice Recognition, Voice Communication
    • Description: Select the Android audio source for the microphone. "Voice Communication" is recommended for echo cancellation.

  • Mic Sample Rate

    • Options: 16kHz, 44.1kHz, 48kHz
    • Description: Sets the sampling rate for the microphone input.

  • Use AAC Audio

    • Type: Toggle (Experimental)
    • Description: Uses compressed AAC for audio streams to save bandwidth.

Debug Settings

  • Use Native SSL

    • Type: Toggle
    • Description: Uses native OpenSSL for encryption. Highly recommended for performance. Includes 16KB aligned libraries for Android 15 compatibility.

  • Export Logs

    • Action: Button
    • Description: Saves logs to a file for troubleshooting.

Clone this wiki locally