How bpatrik/pigallery2 works
PiGallery2 is a directory-first, read-only photo gallery for low-resource servers. Users browse their photo folders, search media, and use related features such as albums, faces, sharing, and extensions. The frontend routes these experiences; the backend server provides the application runtime, with managers coordinating indexing, search, users, and other domain services over a database. The README documents the product capabilities, while source excerpts and the source index support only selected internal relationships; unsampled subsystem links are therefore omitted.
Main entry points: app.routing.ts Frontend routes · ObjectManagers.ts Manager registry · SearchManager.ts Search manager · SQLConnection.ts SQL connection
Components 21
Gallery client
- Frontend routes
src/frontend/app/app.routing.ts - Gallery browsing
src/frontend/app/ui/gallery - Search interface
src/frontend/app/ui/gallery/search - Albums
src/frontend/app/ui/albums - Face browsing
src/frontend/app/ui/faces - Sharing
src/frontend/app/ui/gallery/share.service.ts - Administration
src/frontend/app/ui/admin/admin.component.ts - Extension settings
src/frontend/app/ui/settings/extension-installer
Server runtime
- Backend server
src/backend/server.ts - HTTP routing
src/backend/routes/Router.ts - Manager registry
src/backend/model/ObjectManagers.ts - Server configuration
src/common/config/private/Config.ts
Media and search
- Directory scanning
src/backend/model/fileaccess/DiskManager.ts - Background jobs
src/backend/model/jobs/JobManager.ts - Search manager
src/backend/model/database/SearchManager.ts - Search query model
src/common/entities/SearchQueryDTO.ts - Directory data
src/common/entities/DirectoryDTO.ts
Persistence
- SQL connection
src/backend/model/database/SQLConnection.ts - Directory entity
src/backend/model/database/enitites/DirectoryEntity.ts
Extensions
- Extension manager
src/backend/model/extension/ExtensionManager.ts
Other components
- Gallery user
Connections 20
- Gallery user → Frontend routes: opens app
README.md - Frontend routes → Gallery browsing: routes to
src/frontend/app/app.routing.ts - Frontend routes → Albums: routes to
src/frontend/app/app.routing.ts - Frontend routes → Face browsing: routes to
src/frontend/app/app.routing.ts - Frontend routes → Administration: routes to
src/frontend/app/app.routing.ts - Backend server → Manager registry: initializes
src/backend/server.ts - Backend server → HTTP routing: imports
src/backend/server.ts - Manager registry → SQL connection: initializes
src/backend/model/ObjectManagers.ts - Manager registry → Search manager: creates
src/backend/model/ObjectManagers.ts - Manager registry → Background jobs: creates
src/backend/model/ObjectManagers.ts - Manager registry → Extension manager: creates
src/backend/model/ObjectManagers.ts - Search manager → SQL connection: queries
src/backend/model/database/SearchManager.ts - Search manager → Search query model: accepts
src/backend/model/database/SearchManager.ts - Directory scanning → Directory data: builds
src/backend/model/fileaccess/DiskManager.ts - SQL connection → Directory entity: registers
src/backend/model/database/SQLConnection.ts - Server configuration → Extension manager: configures
src/common/config/private/Config.ts - Extension settings → Extension manager: installs
README.md - Search interface → Search manager: submits queries
- Gallery browsing → Directory scanning: browses folders
- Sharing → HTTP routing: uses sharing routes