How it works
+--------------+ HTTPS/TLS +--------------+
| | Local Network | |
| Android | ------------------> | Linux |
| Phone | mDNS Discovery | Desktop |
| | | |
+--------------+ +--------------+
- Install the server on your Linux machine.
- Open the app on your Android phone.
- Scan the QR code shown by the server.
- Done: notifications appear on your desktop.
The server and the app find each other automatically using mDNS. All communication is encrypted with TLS.
Features
- Zero cloud: everything stays on your local network.
- Encrypted: TLS with auto-generated certificates.
- Zero config: mDNS auto-discovery, no IP addresses to type.
- Battery friendly: minimal impact on your phone.
- Works everywhere: GNOME, KDE, XFCE, i3, Sway and more.
Requirements
- Server: Linux with D-Bus notifications (any modern desktop).
- App: Android 14 or later.
- Network: both devices on the same local network.
Install
Server (Linux)
Fedora / RHEL 10 / CentOS Stream 10:
sudo dnf copr enable alessandrolattao/lanotifica
sudo dnf install lanotifica
Ubuntu / Debian:
curl -sLO $(curl -s https://api.github.com/repos/alessandrolattao/lanotifica/releases/latest | grep -o 'https://[^"]*\.deb') && sudo dpkg -i lanotifica_*.deb && rm lanotifica_*.deb
Start the server:
systemctl --user enable --now lanotifica
Then open https://localhost:19420 and scan the QR code with the app.
App (Android)
Get it on Google Play, or build it from source in the app/ folder of the repository.
Security
- Token-based authentication: a unique token generated on setup.
- Certificate pinning: the fingerprint is verified via the QR code.
- End-to-end encryption: all traffic goes over TLS.
- LAN only: nothing leaves your local network.
Documentation
LaNotifica is developed by Alessandro Lattao and released as open source under the AGPL-3.0 license. For further details, go to the README on GitHub: you will find the documentation there, as Markdown files.
Bugs and feature requests: GitHub issues.
