Search and inspect your Home Assistant configuration from Android (Termux toolkit)
Hi,
I built a small toolkit that makes it easier to work with a Home Assistant configuration directly from an Android phone using Termux.
The idea is simple: keep a local mirror of your HA configuration on your phone and use fast command-line tools to inspect or search it.
What it does
The toolkit currently includes two scripts.
ha_restore.sh
Extracts a Home Assistant backup .tar from the phone’s Download folder and creates a local mirror of the configuration at /storage/emulated/0/HA/data/.
This does not interact with the running Home Assistant instance. It simply extracts configuration files locally so they can be inspected or searched.
Safety features:
- Confirmation dialog before replacing files
- Previous mirror preserved with timestamp
- Validation of backup structure before extraction
ha_find_contexte.sh
Search any keyword across your configuration files and display results with context lines, so matches can be understood immediately without opening any file.
Features:
- Native Android dialog to enter the search term
- Recursive search using ripgrep
- ±5 lines of context around each match
- Formatted output report opened automatically
Example result:
------------------------------------------------------------
Fichier : /storage/emulated/0/HA/data/automations.yaml
------------------------------------------------------------
4 | trigger:
5 | platform: state
6 | entity_id: binary_sensor.door
>>> 7 | action: notify.mobile_app
8 | message: "Door opened"
Typical workflow
Home Assistant
│
│ export backup
▼
backup.tar (Download/)
│
│ ha_restore.sh
▼
local mirror on phone
│
│ ha_find_contexte.sh
▼
search results
Requirements
- Android + Termux (F-Droid version)
ripgrep,jq,termux-api
Full documentation and installation instructions are available in the repository.
Feedback welcome 