Skip to content

alessandrolattao/lanotifica

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

117 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LaNotifica

LaNotifica

Forward Android notifications to your Linux desktop.

CI Google Play Android 14+ Tested on Pixel 8 Pro Go AGPL-3.0 License

Your phone notifications, on your desktop.
WhatsApp, Telegram, calls, everything.


How it works

┌──────────────┐      HTTPS/TLS       ┌──────────────┐
│              │    Local Network     │              │
│   Android    │ ──────────────────►  │    Linux     │
│    Phone     │    mDNS Discovery    │   Desktop    │
│              │                      │              │
└──────────────┘                      └──────────────┘
  1. Run the server on your Linux machine
  2. Scan the QR code with the Android app
  3. Done. Notifications appear on your desktop

Features

Feature Description
🔒 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...

Quick Start

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 (Fedora/Ubuntu):

systemctl --user enable --now lanotifica

Then open https://localhost:19420 and scan the QR code.

App (Android)

Or build from source in app/.


Requirements

Component Requirement
Server Linux with D-Bus notifications (any modern desktop)
App Android 14+ (API 34)
Network Both devices on the same local network

Security

  • Token-based authentication — Unique token generated on setup
  • Certificate pinning — Fingerprint verified via QR code
  • End-to-end encryption — All traffic over TLS
  • LAN only — Never leaves your local network

License

AGPL-3.0