How openlistteam/openlist works
OpenList is a self-hosted, multi-storage file access and sharing server. A principal workflow starts with a client request, enters through the HTTP router, and reaches file handlers; the README also documents browsing, preview, downloads, file management, sharing, and integrations such as WebDAV and offline downloads. Storage administration persists configurations and loads enabled mounts through the storage operations layer. The graph includes documented capabilities whose detailed implementation was not sampled; those branches are not presented as verified call paths.
Main entry points: handles File handlers · router.go HTTP router · op/storage.go Storage lifecycle · handles/storage.go Storage admin
Components 20
HTTP access
- HTTP router
server/router.go - File handlers
server/handles - MCP interface
server/mcp/handler.go - WebDAV access
server/webdav/webdav.go - Storage admin
server/handles/storage.go
File capabilities
- File operations
internal/fs - Archive access
internal/archive - Sharing
internal/sharing - Multipart uploads
internal/multipart/session.go
Storage runtime
- Storage lifecycle
internal/op/storage.go - Mount details
internal/op/storage_details.go - Storage adapters
drivers - Storage records
internal/db/storage.go - Startup loading
internal/bootstrap/storage.go
Media and tasks
- Search
internal/search/search.go - Media library
internal/media/scanner.go - Offline downloads
internal/offline_download - Video transcoding
internal/transcode/chunk_manager.go - Task manager
internal/task/manager.go
Other components
- Client
Connections 20
- Client → HTTP router: requests
server/router.go - HTTP router → File handlers: routes to
server/router.go - HTTP router → MCP interface: registers
- HTTP router → WebDAV access: serves
- HTTP router → Storage admin: routes to
- Storage admin → Storage lifecycle: manages
server/handles/storage.go - Storage lifecycle → Storage records: persists
internal/op/storage.go - Startup loading → Storage records: loads enabled
internal/bootstrap/storage.go - Startup loading → Storage lifecycle: initializes mounts
internal/bootstrap/storage.go - Storage lifecycle → Storage adapters: initializes
- Storage admin → Mount details: reads details
server/handles/storage.go - File handlers → File operations: uses
- File handlers → Archive access: supports packages
- File handlers → Sharing: serves shares
- File handlers → Multipart uploads: uploads chunks
- File handlers → Search: searches
server/handles/index.go - Client → Offline downloads: requests downloads
- Client → Media library: previews media
- Client → Video transcoding: streams video
- Offline downloads → Task manager: schedules tasks