How warlocks365/panomint works
Panomint is a self-hosted 360° photo and video library. Users upload or scan media into a searchable library, then browse timelines, maps, people, and albums; they can play panoramic media and create public shares. The graph preserves the documented AI, account, administration, and network-storage capabilities. README statements support most backend and product links; frontend-to-backend details are shown only where excerpts establish them. Backend internals were not sampled, so their wiring is intentionally limited.
Main entry points: main.js Vue application · handlers.go Media management · MapView.vue Map browsing · transcode.go HLS transcoding
Components 26
User experience
- Vue application
src/frontend/src/main.js - Timeline browsing
src/frontend/src/views/TimelineView.vue - Map browsing
src/frontend/src/views/MapView.vue - Panorama playback
src/frontend/src/views/PlayerView.vue - Public sharing
src/frontend/src/views/SharePublicView.vue - HLS transcoding
src/backend/internal/transcode/transcode.go
Media ingestion
- Media upload
src/frontend/src/components/upload/uploadManager.js - Directory scanning
src/backend/internal/index/handler.go - Network mounts
src/backend/internal/storage/handler.go - Mount administration
src/frontend/src/views/admin/StorageTab.vue - Media management
src/backend/internal/media/handlers.go
Library discovery
- Albums and groups
src/backend/internal/albums/handlers.go - Semantic search
src/backend/internal/search/query.go - People clustering
src/backend/internal/faces/cluster.go - Geographic services
src/backend/internal/geo/handlers.go
AI capabilities
- Vector embeddings
src/backend/internal/embed/embed.go - Automatic tagging
src/backend/internal/tags/applier.go
Accounts and operations
- Authentication and roles
src/backend/internal/auth/handlers.go - Administration
src/frontend/src/views/AdminView.vue - Audit history
src/backend/internal/audit/handlers.go - Go API service
src/backend/cmd/api/main.go
Other components
- Library user
- PostgreSQL and extensions
- Valkey queue
- FFmpeg
- Map tile provider
Connections 31
- Library user → Vue application: browses
- Vue application → Media upload: uploads media
- Vue application → Timeline browsing: browses timeline
- Vue application → Map browsing: explores map
- Vue application → Panorama playback: plays media
- Vue application → Public sharing: opens shares
- Vue application → Mount administration: manages mounts
src/frontend/src/views/admin/StorageTab.vue - Mount administration → Network mounts: configures mounts
- Mount administration → Directory scanning: starts scans
- Media upload → Go API service: posts upload
src/frontend/src/components/upload/uploadManager.js - Directory scanning → Media management: imports media
- Network mounts → Media management: provides media source
- Media management → PostgreSQL and extensions: persists library
- Timeline browsing → Media management: retrieves media
- Map browsing → Geographic services: requests locations
- Map browsing → Map tile provider: loads tiles
- Panorama playback → HLS transcoding: requests HLS
- HLS transcoding → FFmpeg: runs transcoding
- HLS transcoding → Valkey queue: queues jobs
- Vue application → Semantic search: searches library
- Semantic search → Vector embeddings: retrieves vectors
- Vector embeddings → PostgreSQL and extensions: queries vectors
- Media management → Automatic tagging: applies tags
- Media management → People clustering: detects faces
- Media management → Albums and groups: organizes albums
- Public sharing → Media management: serves shared media
- Library user → Authentication and roles: signs in
- Administration → Authentication and roles: manages accounts
- Administration → Audit history: reviews history
- Vue application → Go API service: sends API requests
- Go API service → PostgreSQL and extensions: uses database