Skip to content

Settings

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

Application Settings

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

General Settings

  • Night Mode

    • Options: Auto, Day, Night, Auto (Wait for GPS), None
    • Description: Controls the day/night theme of the Android Auto projection. "Auto" uses the system time or sensor data. "Auto (Wait for GPS)" delays the switch until a GPS lock determines sunset/sunrise times at your location.

  • Mic Sample Rate

    • Options: 8kHz, 16kHz, 24kHz, 32kHz, 44.1kHz, 48kHz
    • Description: Sets the sampling rate for the microphone input passed to Android Auto. Default is 16kHz. Adjust this if you experience audio quality issues with voice commands.

  • Keymap

    • Description: Opens the Keymap configuration screen where you can map physical keys (like steering wheel buttons) to Android Auto functions.

  • GPS for Navigation

    • Type: Toggle
    • Description: If enabled, the head unit's GPS data is shared with the phone to improve navigation accuracy and save phone battery.

  • Wireless Headunit Server (formerly Wireless Launcher Mode)

    • Type: Toggle
    • Description: Enables the background service that listens for wireless Android Auto connections. This is required for wireless projection to start automatically or manually.

  • Auto start Self-Mode

    • Type: Toggle
    • Description: Automatically starts the "Self-Mode" (local Android Auto simulation) when the application is launched.

  • Auto-Connect Last Session

    • Type: Toggle
    • Description: Automatically attempts to reconnect to the last used device (WiFi or USB) when the application starts.

  • Right-hand drive

    • Type: Toggle
    • Description: Adjusts the Android Auto UI for right-hand drive vehicles (e.g., places the navigation bar on the right side). Requires a reconnection to take effect.

Graphic Settings

  • Resolution

    • Options: Auto, 480p (800x480), 720p (1280x720), 1080p (1920x1080), 1440p (2560x1440)
    • Description: Sets the video resolution negotiated with the phone. "Auto" attempts to match the screen resolution. Higher resolutions require more bandwidth and processing power.

  • DPI

    • Input: Numeric Value (Enter 0 for Auto)
    • Description: Sets the screen density (Dots Per Inch). This affects the size of UI elements (icons, text) in Android Auto. Lower values make elements larger, higher values make them smaller.

  • Start in Fullscreen Mode

    • Type: Toggle
    • Description: If enabled, the projection screen will hide the Android status bar and navigation bar (Immersive Mode) to maximize screen real estate.

  • View Mode

    • Options: SurfaceView, TextureView, GLES20
    • Description: Selects the Android View type used for rendering the video stream.
      • SurfaceView: Generally more performant and battery-efficient. Recommended for most devices.
      • TextureView: Supports alpha (transparency) and complex animations better but might have slightly higher overhead. Use this if SurfaceView causes layout issues or glitches.
      • GLES20: Uses OpenGL ES 2.0 for rendering. Recommended for older Head Units (Android 8.1 or older) where standard views produce black screens, artifacts, or scaling issues.

Video Settings

  • Force Software Decoding

    • Type: Toggle
    • Description: Forces the app to use a software video decoder (e.g., ffmpeg/google.h264) instead of the device's hardware decoder. Useful if the hardware decoder is buggy or incompatible, but significantly increases CPU usage.

  • Video Codec

    • Options: Auto, H.264, H.265
    • Description: Selects the video compression format.
      • H.264 (AVC): Standard, supported by almost all devices.
      • H.265 (HEVC): Better compression (less bandwidth, potentially better quality), but requires compatible hardware support on both phone and head unit.
      • Auto: Automatically negotiates the best available codec.

  • FPS Limit

    • Options: 30 FPS, 60 FPS
    • Description: Limits the frame rate of the video stream. 30 FPS is standard and more stable on slower WiFi. 60 FPS provides smoother motion but requires a stable, high-bandwidth connection (5GHz WiFi recommended).

Audio Settings

  • Enable Audio Sink

    • Type: Toggle (Default: On)
    • Description: If enabled, the Head Unit advertises itself as an audio sink (speaker). Android Auto will route audio (Music, Navigation, Calls) to the Head Unit. Disable this if you want the phone to handle audio output directly (e.g., via Bluetooth to the car speakers).

  • Use AAC Audio

    • Type: Toggle (Default: Off)
    • Description: (Experimental) Requests AAC compressed audio instead of uncompressed PCM. This can reduce WiFi bandwidth usage but requires compatible decoding on the Head Unit.

Debug Settings

  • Debug Mode

    • Type: Toggle
    • Description: Enables verbose logging to Logcat. Useful for troubleshooting connection issues or crashes.

  • Export Logs

    • Action: Button
    • Description: Captures the current application logs and saves them to a file in the app's external data folder. You can then share this file via email/bluetooth or save it locally for debugging.

  • Use Native SSL

    • Type: Toggle
    • Description: Uses the native OpenSSL library (via JNI) for encryption/decryption instead of the Java SSLEngine. This is significantly faster on older devices (e.g. Rockchip/Mediatek head units) and can prevent audio stuttering or connection lag. Requires a restart.

  • Bluetooth Address

    • Input: MAC Address (XX:XX:XX:XX:XX:XX)
    • Description: The Bluetooth MAC address of the head unit (this device). This is sometimes required for the initial handshake in wireless connections if automatic discovery fails.

Info

  • Version: Displays the current version of the app.
  • About: Shows copyright and license information.

Clone this wiki locally