HomeCar
Home Assistant dashboard for Android Auto
Download APK · Installation (English / Español) · Report a problem
HomeCar displays a configurable Home Assistant dashboard in a dedicated Android Auto interface. It is a community project based on the open-source Fermata Media Player codebase.
Current candidate: v1.0.0-rc.2 (pre-release). This is not a final, universally compatible 1.0.0. Android Auto acceptance varies by Android version, head unit and installation method. The RC2 APK is debug-signed for testing; later APKs signed with another key cannot be installed over it without uninstalling the old package.
What HomeCar provides
- A dedicated Home Assistant WebView with configurable server URL (HTTPS domain or local HTTP address).
- Persistent Home Assistant cookies, application preferences and navigation state, subject to Android WebView and OS lifecycle limits.
- Reuse of the existing WebView while switching between Android Auto apps, reducing avoidable dashboard reloads.
- Standard Android WebView HTTP cache, rather than forcing a network reload on every return.
- WebView navigation and SSL/TLS improvements, plus optional client certificate support (mTLS) requiring device-specific testing.
- Removal of inherited photo/video/media storage permissions from the Android Auto flavor.
- Phone-side check for published GitHub Releases, at most once per day, plus a manual check in the server settings. It does not auto-download or auto-install APKs.
- A universal APK bundling the dynamic Web module, built with Android SDK 36 and Bundletool.
Download and install
Get the APK from the GitHub Releases page. For RC2, open the v1.0.0-rc.2 pre-release and download HomeCar-1.0.0-RC2.apk from Assets.
Use the .apk asset, not Source code ZIP and not .apks (a Bundletool container).
- Install the APK on the Android phone. If HomeCar is absent from Android Auto, a device-specific installation method may be necessary.
- Open HomeCar on the phone, tap Settings and enter your Home Assistant URL, e.g.
https://home.example.com/orhttp://192.168.1.100:8123/. - Log into Home Assistant, verify access, and configure Android Auto's launcher while the vehicle is parked.
- If HomeCar is not listed in the Android Auto launcher, follow the KingInstaller + Shizuku guide.
KingInstaller does not guarantee Android Auto compatibility. Android Auto may reject the inherited projection service at the system validator, even when APK installation succeeds; see issue #9.
Installer resources
- KingInstaller (fcaronte, official GitHub)
- Shizuku (RikkaApps, official GitHub)
- Step-by-step installation, debugging, and recovery guide
RC2 validation status
| Check | Status |
|---|---|
| Static checks of RC2 patches | Passed locally |
:fermata:bundleAutoDebug |
Built successfully locally |
| Bundletool universal debug APK | Generated and installed locally |
| Home Assistant dashboard in Android Auto | Working in one real-world setup reported by the maintainer |
| Return to dashboard after switching applications in DHU | Observed to preserve the view and return quickly |
| Android Lint | Not completed (previous run was interrupted) |
| BMW/Mercedes rotary-controller compatibility | Not validated; PR #8 under review |
| Compatibility across devices/Android Auto releases | Not guaranteed; several open issues |
| Security audit and release signing | Not complete |
See RC2 release notes and test matrix.
How to build
Requirements: JDK shipped with Android Studio, Android SDK/API 36, Android NDK/CMake as required by Gradle, Git, and Google Bundletool.
git clone https://github.com/RenanEspinar/HomeCar.git
cd HomeCar
.\gradlew.bat :fermata:bundleAutoDebug
The Android Auto flavor has a dynamic web feature. Convert the built AAB to a universal APK:
java -jar bundletool.jar build-apks --bundle="fermata/build/outputs/bundle/autoDebug/homecar-1.0.0-rc.2-auto-debug.aab" --output=HomeCar.apks --mode=universal --overwrite
Open HomeCar.apks as a ZIP archive and extract universal.apk. Debug APKs are not production distribution artifacts. For a stable release, use a secure, backed-up signing key and publish a consistently signed APK.
Architecture
Android Auto projection -> HomeCar CarService -> HomeCar UI -> Android WebView -> Home Assistant
|
+-> Android WebView cookies/cache
Phone settings -> Local preference store +-> Github Releases update check
The project retains Fermata-derived Android Auto projection infrastructure. A Car App Library IoT template-based interface is a possible future compatibility path, but it cannot embed an arbitrary Lovelace WebView.
Reporting problems
Use GitHub Issues. Please include your phone model, Android version, Android Auto version, head unit/vehicle, APK version, installer, and precise reproduction steps. Remove Home Assistant URLs, session tokens, credentials, personal details and logs containing private data before posting.
Known investigations: #1 Security, #6 WebView reload, #7 Rotary controls, #9 Launcher visibility, #12 mTLS, #14 Fermata coexistence, #15 Back button.
Credits, safety and license
Maintained by Renan Espinar. HomeCar is derived from Fermata Media Player by Andrey Pavlenko. All inherited copyrights and author attributions remain applicable. Distributed under the GNU General Public License v3.0. No affiliation or endorsement from Google, Android Auto, Home Assistant or Nabu Casa is implied.
Do not operate doors, gates, cameras, alarms or other potentially distracting controls while driving. Configure and test while parked. HomeCar is not a certified automotive safety system.
