Architecture

Components

LaNotifica consists of two components:

Server - A Go application that runs on your Linux desktop. It receives notifications from the Android app and displays them using D-Bus desktop notifications.

App - An Android application that listens for notifications and forwards them to the server over your local network.

Communication Flow

1. Server starts and generates a unique authentication token
2. Server advertises itself on the local network using mDNS
3. User scans a QR code containing the server URL, token, and certificate fingerprint
4. App stores the configuration securely
5. App discovers the server via mDNS
6. When a notification arrives on the phone, the app sends it to the server over HTTPS
7. Server displays the notification on the desktop

Discovery

The server uses mDNS (Multicast DNS) to advertise itself on the local network. The app automatically discovers the server without requiring manual IP configuration.

This works on any network that allows multicast traffic (most home and office networks).

Notifications

The server uses D-Bus to display notifications on Linux. This is the standard notification system supported by all major desktop environments.

When a notification is dismissed on the phone, the server also dismisses it on the desktop.