Settings

Application Settings

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

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

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

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.
Force Legacy Decoder
- Type: Toggle
- Description: Forces the use of the legacy (Synchronous) MediaCodec implementation. Enable this on older devices or specific chipsets (like some Mediatek models) that crash with the modern Asynchronous decoder.
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).

Debug Mode
- Type: Toggle
- Description: Enables verbose logging to Logcat. Useful for troubleshooting connection issues or crashes.
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.