How seriousm4x/upsnap works
UpSnap is a self-hosted Wake-on-LAN dashboard. A user manages devices and permissions in the web UI, then wakes, shuts down, or monitors devices; scheduled jobs automate status checks and wake/shutdown actions. The graph includes documented device discovery, port checks, IP tracking, user administration, logs, localization, and settings. Source excerpts confirm only selected backend and frontend calls, so other capability links are documented rather than inferred from co-location.
Main entry points: pocketbase.ts PocketBase client · handlers.go Device handlers · cronjobs.go Scheduled jobs · +layout.svelte App shell
Components 26
Web interface
- App shell
frontend/src/routes/+layout.svelte - Device dashboard
frontend/src/routes/+page.svelte - Device management
frontend/src/lib/components/DeviceForm.svelte - Scan interface
frontend/src/lib/components/NetworkScan.svelte - Account management
frontend/src/routes/account/+page.svelte - Admin pages
frontend/src/routes/users/+page.svelte - Log viewer
frontend/src/routes/logs/+page.svelte - Settings
frontend/src/routes/settings/+page.svelte - Localization
frontend/src/lib/stores/locale.ts - PocketBase client
frontend/src/lib/stores/pocketbase.ts
PocketBase application
- Application entry
backend/main.go - PocketBase setup
backend/pb/pb.go - Device handlers
backend/pb/handlers.go - Scan handler
backend/pb/handlerscan_linux.go - Authorization middleware
backend/pb/middlewares.go - PocketBase records
Network operations
- Wake packets
backend/networking/magicpacket.go - Device control
backend/networking/wake.go - Shutdown commands
backend/networking/shutdown.go - Reachability checks
backend/networking/ping.go - Network discovery
backend/networking/scan.go - IP tracking
backend/iptracking/iptracking.go
Automation
- Scheduled jobs
backend/cronjobs/cronjobs.go - Logging
backend/logging/logging.go
Other components
- User
- Nmap
Connections 31
- User → App shell: uses
README.md - App shell → PocketBase client: loads auth and settings
frontend/src/routes/+layout.svelte - App shell → Device dashboard: renders routes
- Device dashboard → PocketBase client: subscribes to records
frontend/src/routes/+page.svelte - Device management → PocketBase client: saves devices
frontend/src/lib/components/DeviceForm.svelte - User → Device management: configures devices
- User → Scan interface: discovers devices
README.md - User → Account management: manages account
README.md - User → Admin pages: administers users
README.md - User → Log viewer: reviews logs
README.md - User → Settings: configures app
README.md - App shell → Localization: sets locale
frontend/src/routes/+layout.svelte - Application entry → PocketBase setup: starts
backend/main.go - PocketBase setup → Device handlers: registers routes
- PocketBase setup → Authorization middleware: configures authorization
- PocketBase setup → PocketBase records: uses records
- Device handlers → PocketBase records: reads and saves
backend/pb/handlers.go - Device handlers → Device control: controls devices
backend/pb/handlers.go - Device control → Wake packets: sends wake packet
backend/networking/magicpacket.go - Device handlers → Shutdown commands: requests shutdown
README.md - Scan handler → PocketBase records: reads scan settings
backend/pb/handlerscan_linux.go - Scan handler → Nmap: runs scan
backend/pb/handlerscan_linux.go - Scan interface → PocketBase client: requests scan
- PocketBase client → Application entry: calls PocketBase API
- Scheduled jobs → PocketBase records: reads and updates devices
backend/cronjobs/cronjobs.go - Scheduled jobs → Reachability checks: checks status
backend/cronjobs/cronjobs.go - Scheduled jobs → IP tracking: schedules sweeps
backend/cronjobs/cronjobs.go - Scheduled jobs → Device control: runs timed actions
README.md - IP tracking → Nmap: scans subnets
README.md - Log viewer → PocketBase client: fetches logs
frontend/src/routes/logs/+page.svelte - Device handlers → Logging: records events