How audiobookshelf/audiobookshelf-client-react works
This repository is the Next.js web client for Audiobookshelf, intended to replace its Vue client. Users sign in, browse and search libraries, inspect and manage media, and listen through the shared player; administrators also configure server capabilities. The graph emphasizes those product areas and the sampled connections between them. Many routes and settings subsystems are represented by their existing directories because their implementations were not sampled; their internal wiring is therefore not asserted.
Main entry points: mediaActions.ts Media API actions · MediaContext.tsx Media state · usePlayerHandler.ts Player handler · api.ts API client
Components 22
Identity and shell
- Login
src/app/(blank)/login/LoginForm.tsx - App shell
src/app/(main)/layout.tsx - User state
src/contexts/UserContext.tsx
Library experience
- Library browsing
src/app/(main)/library/[library]/[entityType]/BookshelfClient.tsx - Shelf query
src/hooks/useBookshelfQuery.ts - Library state
src/contexts/LibraryContext.tsx - Library search
src/app/(main)/library/[library]/search/SearchClient.tsx - Media actions
src/components/widgets/media-card/useMediaCardActions.ts
Playback
- Media state
src/contexts/MediaContext.tsx - Player handler
src/hooks/usePlayerHandler.ts - Playback session
src/hooks/usePlaybackSession.ts - Local audio player
src/lib/player/LocalAudioPlayer.ts - Player interface
src/components/player/MediaPlayerContainer.tsx
Administration
- Server settings
src/app/(main)/settings - Authentication settings
src/app/(main)/settings/authentication/AuthenticationClient.tsx - Authentication actions
src/app/(main)/settings/authentication/actions.ts
Client platform
- Media API actions
src/app/actions/mediaActions.ts - API client
src/lib/api.ts - Socket connection
src/contexts/SocketContext.tsx - API data types
src/types/api.ts
Other components
- User
- Audiobookshelf server
Connections 16
- User → Login: signs in
- Library browsing → Shelf query: uses query
- Shelf query → Library state: updates settings
src/hooks/useBookshelfQuery.ts - Library search → Media API actions: requests search
src/app/(main)/library/[library]/search/SearchClient.tsx - Media actions → Media API actions: invokes actions
src/components/widgets/media-card/useMediaCardActions.ts - Media API actions → API client: calls API
src/app/actions/mediaActions.ts - Media state → Media API actions: loads item
src/contexts/MediaContext.tsx - Media state → Player handler: uses handler
src/contexts/MediaContext.tsx - Media state → Player interface: renders player
src/contexts/MediaContext.tsx - Player handler → Playback session: manages session
src/hooks/usePlayerHandler.ts - Player handler → Local audio player: uses backend
src/hooks/usePlayerHandler.ts - Socket connection → Audiobookshelf server: connects to
src/contexts/SocketContext.tsx - User state → Socket connection: subscribes events
src/contexts/UserContext.tsx - Authentication settings → Authentication actions: updates settings
src/app/(main)/settings/authentication/AuthenticationClient.tsx - Authentication actions → API client: uses API
- API client → Audiobookshelf server: requests server