How cedev-1/jellyfin-plugin-getavatar works
GetAvatar is a Jellyfin server plugin for browsing and assigning gallery avatars. Users select an image through the injected profile UI or client API; the controller delegates assignment to avatar services that persist gallery files and Jellyfin profile images. Administrators manage the gallery and settings, with separate import branches for online packs, Gravatar, and Immich album/user-picture synchronization. The graph follows documented capabilities and sampled calls; unsampled UI/API wiring is shown only where README or source-index evidence supports it.
Main entry points: AvatarService.cs Gallery and assignment · AvatarController.cs Avatar API · Web Profile and admin UI · ImmichService.cs Immich API service
Components 18
Jellyfin entry points
- Avatar API
Jellyfin.Plugin.GetAvatar/Controllers/AvatarController.cs - Profile and admin UI
Jellyfin.Plugin.GetAvatar/Configuration/Web - Script injection
Jellyfin.Plugin.GetAvatar/ScriptInjectorMiddleware.cs
Avatar gallery
- Gallery and assignment
Jellyfin.Plugin.GetAvatar/Services/AvatarService.cs - Avatar files and mappings
Jellyfin.Plugin.GetAvatar/Configuration/AvatarInfo.cs - Startup repair
Jellyfin.Plugin.GetAvatar/AvatarValidationService.cs
Avatar sources
- Online pack import
Jellyfin.Plugin.GetAvatar/Services/OnlinePackService.cs - Gravatar download
Jellyfin.Plugin.GetAvatar/Services/GravatarService.cs - Gravatar service
Jellyfin.Plugin.GetAvatar/Services/GravatarService.cs
Immich integration
- Immich API service
Jellyfin.Plugin.GetAvatar/Services/ImmichService.cs - Immich server
Configuration and lifecycle
- Plugin configuration
Jellyfin.Plugin.GetAvatar/Configuration/PluginConfiguration.cs - Plugin registration
Jellyfin.Plugin.GetAvatar/Plugin.cs - New-user assignment
Jellyfin.Plugin.GetAvatar/Services/UserCreatedAvatarConsumer.cs
Other components
- Jellyfin users
- Jellyfin admins
- Jellyfin clients
- Jellyfin server
Connections 22
- Jellyfin users → Profile and admin UI: opens picker
README.md - Jellyfin clients → Avatar API: calls API
README.md - Jellyfin admins → Profile and admin UI: manages gallery
README.md - Profile and admin UI → Avatar API: requests actions
- Jellyfin server → Script injection: runs middleware
- Script injection → Profile and admin UI: injects picker
Jellyfin.Plugin.GetAvatar/ScriptInjectorMiddleware.cs - Avatar API → Gallery and assignment: delegates avatar work
Jellyfin.Plugin.GetAvatar/Controllers/AvatarController.cs - Avatar API → Online pack import: imports packs
Jellyfin.Plugin.GetAvatar/Controllers/AvatarController.cs - Avatar API → Gravatar download: requests download
Jellyfin.Plugin.GetAvatar/Controllers/AvatarController.cs - Avatar API → Immich API service: routes sync actions
Jellyfin.Plugin.GetAvatar/Controllers/AvatarController.cs - Online pack import → Gallery and assignment: saves imported images
Jellyfin.Plugin.GetAvatar/Services/OnlinePackService.cs - Gravatar service → Gravatar download: downloads image
Jellyfin.Plugin.GetAvatar/Services/GravatarService.cs - Immich API service → Immich server: fetches albums and pictures
Jellyfin.Plugin.GetAvatar/Services/ImmichService.cs - Immich API service → Gallery and assignment: imports and sets pictures
Jellyfin.Plugin.GetAvatar/Services/ImmichService.cs - Gallery and assignment → Avatar files and mappings: stores gallery metadata
Jellyfin.Plugin.GetAvatar/Services/AvatarService.cs - Gallery and assignment → Jellyfin server: updates user profiles
Jellyfin.Plugin.GetAvatar/Services/AvatarService.cs - Gallery and assignment → Plugin configuration: reads and saves mappings
Jellyfin.Plugin.GetAvatar/Services/AvatarService.cs - Startup repair → Gallery and assignment: repairs profile images
Jellyfin.Plugin.GetAvatar/AvatarValidationService.cs - Avatar API → Plugin configuration: updates settings
- Plugin registration → Plugin configuration: owns configuration
Jellyfin.Plugin.GetAvatar/Plugin.cs - New-user assignment → Gallery and assignment: assigns new-user avatar
Jellyfin.Plugin.GetAvatar/Services/UserCreatedAvatarConsumer.cs - Plugin registration → Profile and admin UI: registers pages
Jellyfin.Plugin.GetAvatar/Plugin.cs