explaingit

dw2lam/openlauncher

18KotlinAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

A custom Android home screen for aftermarket car head units that replaces generic phone-style launchers with a dashboard-designed widget grid featuring a speedometer, trip meter, FM radio, and offline-first weather.

Mindmap

mindmap
  root((openlauncher))
    What it does
      Car dashboard UI
      Drag-and-drop grid
      Day/night themes
    Widgets
      GPS speedometer
      FM radio
      Trip meter
      Music player
    Features
      Offline first
      CarPlay detection
      Acceleration timer
    Customization
      Accent colors
      Fonts and scale
      Widget resize
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Replace the stock launcher on an aftermarket Android head unit with one designed for dashboard use

USE CASE 2

Add a GPS speedometer, trip meter, and hidden 0-to-100 acceleration timer to your car dashboard

USE CASE 3

Set up automatic day/night theme switching based on local sunrise and sunset times without any internet connection

USE CASE 4

Customize widget layout and accent colors to match your car interior with no developer account needed

Tech stack

KotlinAndroid

Getting it running

Difficulty · moderate Time to first run · 30min

Requires sideloading an APK onto an Android head unit, compatibility varies across aftermarket hardware models.

MIT license, use, modify, and distribute freely for any purpose, including commercial use.

In plain English

Open Launcher is an Android home screen replacement built specifically for aftermarket car head units, the Android tablets that get installed in a car's dashboard in place of the factory stereo. Most aftermarket head units run a generic Android build, so their default launchers are designed for phones rather than cars. This project replaces that launcher with one designed to look and feel like factory dash software. The design philosophy is offline-first. Car head units are typically not connected to Wi-Fi most of the time since they rely on your phone's CarPlay or Android Auto for navigation. Open Launcher is built around that assumption: speed, compass, trip meter, and day/night switching all work without an internet connection. Weather widgets hide cleanly when offline rather than showing broken boxes. The home screen is a drag-and-drop grid where each widget pane can be moved, resized, and stacked. The widget library includes car-specific tools: a music player that detects CarPlay or Android Auto and switches to shortcut mode automatically, an FM/AM radio display with presets, a GPS speedometer, an altimeter, a trip meter with a hidden 0-to-100 acceleration timer, a soundboard with assignable pads, a weather card, and a CPU/memory monitor for checking whether the head unit is overheating on a long drive. The day/night theme engine offers four modes, including a sunset mode that switches at local sunrise and sunset using offline location math, which is useful for head units that cannot read the car's headlight signal directly. Accent color, background, fonts, text scale, and UI scale are all adjustable from the settings menu. The project is open source under the MIT license and explicitly welcomes testing across different head unit models, since hardware compatibility varies widely in the aftermarket car audio space.

Copy-paste prompts

Prompt 1
I'm installing Open Launcher on my aftermarket Android head unit. Walk me through sideloading the APK and setting it as the default home screen.
Prompt 2
How do I configure the sunset mode in Open Launcher so it switches day/night themes based on local sunrise/sunset times without needing internet access?
Prompt 3
I want to set up the FM radio widget in Open Launcher with preset stations. What are the configuration steps?
Prompt 4
Open Launcher's music widget keeps showing shortcut mode instead of the full player. How do I check whether CarPlay or Android Auto is being detected on my head unit?
Open on GitHub → Explain another repo

← dw2lam on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.