Lantern Hub 🦀

Cross-platform monitoring dashboard: network scanner, IP tracker, hosts manager, and utilities (Rust + egui).

A lightweight, modular desktop application for monitoring network resources, managing local hosts, and running productivity utilities across Linux, macOS, and Raspberry Pi.

Early Development - Project scaffolding and architecture in progress (no working UI yet).

Core Monitoring:

• IP Information Panel - Local and public IP addresses
• LAN Network Scanner - Discover active hosts with hostname resolution
• Hosts File Viewer - Read system hosts file with syntax highlighting

Productivity Widgets:

• Timers & Countdowns - Pomodoro timers, stopwatch, clocks
• Personal Management Tools - Task tracking, notes

Future Possibilities:

• Email notification checking
• System resource charting (CPU, memory, disk)
• Quick application launcher
• File indexing and search
• AI assistant integration
• Custom widget plugins

Lantern Hub is a unified dashboard and common entry point for monitoring and productivity widgets - think of it as:

• Like YaST or GNOME Settings - but for monitoring instead of configuration
• Like Raycast or Alfred - but with persistent monitoring panels instead of just quick actions
• Like Conky or GeekTool - but interactive and modular instead of static desktop widgets
• Like Grafana or Netdata - but lightweight, offline-first, and personal-scale
• Similar to AI assistant apps - a single place you open for various tasks and information

The Core Concept: Instead of running separate apps for network monitoring, system stats, timers, and utilities, Lantern Hub provides a single native application where you compose the widgets you need into your personal monitoring station.

Design Philosophy:

• Dashboard-first approach - Your personal hub for monitoring and utilities
• Modular widget architecture - Compose your own monitoring panels
• Cross-platform native - Linux, macOS, Raspberry Pi (Windows planned)
• Lightweight & fast - Minimal resource footprint, native performance
• No admin privileges required - Works without sudo (until necessary)
• Pure Rust business logic - OS-specific operations abstracted
• Offline-first - Fully functional without network connectivity

• Rust 1.70+ (stable channel)
• Platform: Linux, macOS, or Raspberry Pi (Windows support planned)

git clone https://github.com/dominikj111/lantern-hub.git
cd lantern-hub
cargo build --release
./target/release/lantern-hub

Modular, single-binary architecture:

Presentation Layer     → egui GUI widgets (via egui-desktop)
         ↓
Service Layer          → Business logic (singleton-registry)
         ↓
Platform Abstraction   → OS-specific operations abstracted
         ↓
System Integration     → Rust crates preferred, bash/python fallback

Key Dependencies:

• egui-desktop - Desktop app framework (mandatory)
• singleton-registry - Service DI pattern (mandatory)
• Platform-specific networking crates (local-ip-address, surge-ping, etc.)

Phase 1: MVP Development

• ✅ Project structure established
• 🔄 Building initial widgets and core functionality

Next Steps:

• Working UI prototype
• Release definitions and versioning
• Contribution guidelines
• Additional widget development

Note: Roadmap will evolve as the project matures. See proposal.md for detailed vision and technical planning.

MIT License - see LICENSE for details

Maintainer: @dominikj111