Skip to content

Settings

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

Application Settings

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

General Settings

  • 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.
      • Auto (Time): Uses the current system time and last known location to calculate sunset/sunrise.
      • Auto (Time + GPS): Similar to Auto, but waits for a fresh GPS lock before applying calculated times to ensure accuracy.
      • Light Sensor: Uses the tablet's physical ambient light sensor (if available) to switch modes.
      • Screen Brightness: Monitors the system display brightness. Useful if your tablet/car automatically dims the screen when headlights are turned on.
    • Calculation Info: In Auto modes, the app displays the currently calculated sunrise/sunset times directly in the settings for transparency.

  • Night Mode Threshold (Lux / Brightness)

    • Type: Numeric Input (Dynamic based on mode)
    • Description: Sets the threshold for switching to Night mode.
      • Lux: (For Light Sensor mode) Values between 0-10000. Default is 100. Below this value, the app switches to Night mode.
      • Brightness: (For Screen Brightness mode) Values between 0-255. Default is 40. Below this value, the app switches to Night mode.
    • Hysteresis & Debounce: The app uses a 2-second debounce and a small buffer (Hysteresis) to prevent flickering when the values are near the threshold.

  • 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.

  • Screen Orientation

    • Options: System Default, Auto (Sensor), Landscape (0°), Landscape Reverse (180°), Portrait (90°), Portrait Reverse (270°)
    • Description: Manually overrides the screen orientation of the head unit app. Useful if your device's accelerometer is broken or mounted in a fixed position.

  • 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