Android · Local-first · Open source

Smarthome control your home devices without the cloud.

Pair an Android app with a Go command-line companion to control LG webOS televisions and manage selected AVM FRITZ!Box parental controls on your local network. Credentials stay encrypted on your device; the app includes TV discovery, QR sharing and Wake-on-LAN.

Download APK View source

Project snapshot · measured 2026-10-26

Key facts

Commits 199Last commit 2026-10-06 Source receipt ↗ Commits · 7 days 0 Source receipt ↗ Tickets closed 55 / 59 Source receipt ↗ Studies 5 Source receipt ↗

12-week commit activity

2026-10-26

Aug 3

Aug 10

Aug 17

Aug 24

194

Aug 31

Sep 7

Sep 14

Sep 21

Sep 28

Oct 5

Oct 12

Oct 19

View 12-week data table

Week starting	Commits
2026-08-03	0
2026-08-10	0
2026-08-17	0
2026-08-24	0
2026-08-31	194
2026-09-07	0
2026-09-14	0
2026-09-21	0
2026-09-28	0
2026-10-05	3
2026-10-12	0
2026-10-19	0

Key Features

Control TV power, volume, playback and apps, and see what's currently playing on LG webOS.
Manage FRITZ!Box parental controls by granting extra internet time or blocking access.
Find TVs on the local network and share setup between phone and terminal with QR codes or links.
Wake the TV over the network, including through supported FRITZ!Box routers.

Verified Engineering Milestones

FRITZ!Box internet access controls (#013, 647a770)
Go companion command-line tool (#041, 5cc87ea)
Wake-on-LAN across interfaces and routers (#057, 58d20b8, d4fb91e)

Stack

Kotlin 2.3.21, Android/Gradle, Go 1.26.6, Cobra, LG webOS SSAP, FRITZ!Box TR-064

App preview

One dashboard for household devices

Flimmerkasten (LG TV)

Online on the local network; turn it off or control playback.

Quick Launch

Launch installed apps such as ARD Mediathek and Tagesschau.

TV Online Budget

Check remaining FRITZ!Box time and grant a 45-minute bonus.

Features

Designed for privacy and simple local control

Direct TV control

Wake the TV over the network, power off through SSAP WebSocket, and control playback.

Quick app launch

Pin and launch installed TV apps such as ARD Mediathek, YouTube, and ZDF.

FRITZ!Box parental controls

Check the remaining daily online budget, grant bonus time, or block a device through TR-064.

Encrypted account transfer

Share FRITZ!Box configuration with time-limited AES-256-GCM QR codes and six-digit confirmation codes.

Restricted network scope

Android network security limits cleartext traffic to private LAN subnets and .local hosts.

No cloud or telemetry

No analytics, advertising SDKs, or third-party cloud connections; credentials stay in Android Keystore.

Download

Smarthome v0.1.0 release artifacts

The universal APK requires Android 8.0 (API 26) or newer. Download the standalone release APK, with its SHA256SUMS and Minisign signature.

Verify the release

Check the checksum and signature

sha256sum -c SHA256SUMS
# Expected: smarthome-0.1.0-phase1.apk: OK

Verify the checksum file with Minisign and the release public key below. Long keys and commands scroll within their code blocks on small screens.

RWSh4EKeMIxgiaYw5jABwqGRKTRqFCoftR5iWzJJakbkqz/CwgFaLnHZ

minisign -Vm SHA256SUMS -P RWSh4EKeMIxgiaYw5jABwqGRKTRqFCoftR5iWzJJakbkqz/CwgFaLnHZ

Install on Android

Sideloading guide

1. Download the APK

Download the release file from this page using your mobile browser.

2. Allow installation

In Android settings, allow your browser or file manager to install unknown apps.

3. Play Protect notice

If Android shows an unrecognized-app prompt, review the details and choose Install anyway.

4. Configure local devices

In Settings, enter the TV's local IP and MAC address, and optionally the FRITZ!Box router address and credentials.

Permissions

Access required for local operation

Internet and network state

Send Wake-on-LAN packets and local SSAP and TR-064 requests.

Camera (optional)

Scan encrypted QR codes; images are parsed in memory and never stored.

No background access

No location, contacts, microphone, SMS, or storage permissions.

See the privacy policy and the Impressum for details.

Engineering story

From TV controls to a household toolset

The Go companion made protocol behavior easier to inspect while the Android app grew to include TV discovery, QR sharing, Wake-on-LAN, and selected router controls. Read the Smarthome engineering story.

Project details

Stack

Kotlin 2.3.21, Android/Gradle, Go 1.26.6, Cobra, LG webOS SSAP, FRITZ!Box TR-064

Milestones

FRITZ!Box internet access controls (#013, 647a770) · Go companion command-line tool (#041, 5cc87ea) · Wake-on-LAN across interfaces and routers (#057, 58d20b8, d4fb91e)

Source

https://codeberg.org/ubunatic/smarthome ↗

Architecture

Layer composition

Terminal: CLI, terminal QR codes
Desktop: Android
Inference / AI: —
Containers / VM: —
Web: —

Engineering story

smarthome: the story behind the project

Smarthome began with a small inconvenience: control an LG webOS television without finding its remote. The repository history starts on September 2, 2026, with an Android and Go project scaffold and an issue describing the first power-off f…

Read the engineering story

Measurement source · 2026-10-26

Verification receipts

Commits: 199 · Last commit 2026-10-06
git -C <repo> rev-list --count HEAD; git -C <repo> rev-list --count --since=<ISO-week-Monday> --until=<ISO-week-Sunday> HEAD; git -C <repo> rev-list --count --since=<measured-date-6-days>T00:00:00 --until=<measured-date>T23:59:59 HEAD; git -C <repo> log -1 --format=%cs HEAD; ls <repo>/issues | grep '^[0-9].*\.md$'; grep -l -E '^\*\*Status\*\*: *(Closed|Done|Resolved|Fixed|Complete)' <repo>/issues/*.md | wc -l; ls <repo>/docs/studies/*.md
repositories behind spec project ids in ~/projects; private-repo filter is a safety net and matches no spec project today; missing repos reported separately; seven calendar days ending on measured date in the measuring host's local timezone; commit counts include all authors and merge commits reachable from HEAD · measured 2026-10-26
Commits · 7 days: 0
git -C <repo> rev-list --count HEAD; git -C <repo> rev-list --count --since=<ISO-week-Monday> --until=<ISO-week-Sunday> HEAD; git -C <repo> rev-list --count --since=<measured-date-6-days>T00:00:00 --until=<measured-date>T23:59:59 HEAD; git -C <repo> log -1 --format=%cs HEAD; ls <repo>/issues | grep '^[0-9].*\.md$'; grep -l -E '^\*\*Status\*\*: *(Closed|Done|Resolved|Fixed|Complete)' <repo>/issues/*.md | wc -l; ls <repo>/docs/studies/*.md
repositories behind spec project ids in ~/projects; private-repo filter is a safety net and matches no spec project today; missing repos reported separately; seven calendar days ending on measured date in the measuring host's local timezone; commit counts include all authors and merge commits reachable from HEAD · measured 2026-10-26
Tickets closed: 55 / 59
git -C <repo> rev-list --count HEAD; git -C <repo> rev-list --count --since=<ISO-week-Monday> --until=<ISO-week-Sunday> HEAD; git -C <repo> rev-list --count --since=<measured-date-6-days>T00:00:00 --until=<measured-date>T23:59:59 HEAD; git -C <repo> log -1 --format=%cs HEAD; ls <repo>/issues | grep '^[0-9].*\.md$'; grep -l -E '^\*\*Status\*\*: *(Closed|Done|Resolved|Fixed|Complete)' <repo>/issues/*.md | wc -l; ls <repo>/docs/studies/*.md
repositories behind spec project ids in ~/projects; private-repo filter is a safety net and matches no spec project today; missing repos reported separately; seven calendar days ending on measured date in the measuring host's local timezone; commit counts include all authors and merge commits reachable from HEAD · measured 2026-10-26
Studies: 5
git -C <repo> rev-list --count HEAD; git -C <repo> rev-list --count --since=<ISO-week-Monday> --until=<ISO-week-Sunday> HEAD; git -C <repo> rev-list --count --since=<measured-date-6-days>T00:00:00 --until=<measured-date>T23:59:59 HEAD; git -C <repo> log -1 --format=%cs HEAD; ls <repo>/issues | grep '^[0-9].*\.md$'; grep -l -E '^\*\*Status\*\*: *(Closed|Done|Resolved|Fixed|Complete)' <repo>/issues/*.md | wc -l; ls <repo>/docs/studies/*.md
repositories behind spec project ids in ~/projects; private-repo filter is a safety net and matches no spec project today; missing repos reported separately; seven calendar days ending on measured date in the measuring host's local timezone; commit counts include all authors and merge commits reachable from HEAD · measured 2026-10-26
12-week commit activity
git rev-list --count --since=<Monday> --until=<Sunday> HEAD
12 latest complete ISO weeks; weekly values are from spec/metrics.yaml.