A Jellyfin server plugin that supports the Wholphin Android TV app and provides advanced UI customization options.
Important
This plugin is currenlty only usable with a custom forkof Wholphin!
- Customizable background images for the login screen
- Adjustable transparency (alpha) of the background image
- Configurable blur effects
Flexible home screen configuration with various section types:
- Resume: Continue watching content in progress
- NextUp: Next episodes in series
- Latest: Recently added content
- Items: Custom item queries
- Custom: Custom plugin endpoints
Currenlty only pushing the Seerr URL is supported, more settings will follow soon.
- Open your Jellyfin server dashboard
- Navigate to Dashboard → Plugins → Repositories
- Click the + button to add a new repository
- Enter the following details:
- Repository Name:
Wholphin Plugin - Repository URL:
https://raw.githubusercontent.com/kamilkosek/jellyfin-plugin-wholphin/main/manifest.json
- Repository Name:
- Click Save
- Go to Catalog tab
- Find Wholphin in the plugin list and click Install
- Restart your Jellyfin server when prompted
- Download the latest
Jellyfin.Plugin.Wholphin.dllfrom Releases - Copy the DLL to your Jellyfin plugin directory:
- Linux:
/var/lib/jellyfin/plugins/Wholphin/ - Windows:
C:\ProgramData\Jellyfin\Server\plugins\Wholphin\ - macOS:
/var/lib/jellyfin/plugins/Wholphin/
- Linux:
- Restart your Jellyfin server
See usage
This plugin provides the following API endpoints:
Retrieves the login background configuration (no authentication required).
Response:
{
"backgroundUrl": "https://example.com/image.jpg",
"alpha": 0.2,
"blur": 1.0
}Retrieves plugin settings (authentication required). Currently only pushing the Seerr URL is supported, more to follow soon.
Response:
{
"seerrUrl": "https://seerr.example.com"
}Retrieves home screen configuration (authentication required).
Response:
{
"sections": [
{
"id": "resume",
"title": "Continue Watching",
"type": "Resume",
"limit": 20
},
{
"id": "nextup",
"title": "Next Up",
"type": "NextUp",
"limit": 20
}
]
}The plugin can be configured through the Jellyfin admin interface:
- Navigate to Dashboard → Plugins → Wholphin
- Configure the desired settings:
- Login Background Image URL: URL to the background image
- Login Background Alpha: Transparency (0.0 - 1.0)
- Login Background Blur: Blur strength in dp
- Seerr URL: URL to your Seerr instance
- Home Configuration: JSON configuration for home screen sections
- .NET 8.0 SDK
- Jellyfin 10.9.0 or higher
# Using dotnet
dotnet build
# Using Make
make build
# Or build + deploy
make build-and-copyJellyfin.Plugin.Wholphin/
├── Api/ # API Controllers
│ └── WholphinPluginController.cs
├── Configuration/ # Plugin configuration
│ ├── configPage.html # Admin UI
│ └── PluginConfiguration.cs
├── Models/ # Data models
│ ├── HomeConfiguration.cs
│ ├── HomeSection.cs
│ ├── HomeSectionQuery.cs
│ └── HomeSectionType.cs
├── Plugin.cs # Main plugin class
└── ServiceRegistration.cs # Dependency injection
The project includes predefined VS Code tasks:
- build: Compiles the plugin
- deploy-remote: Deploys the plugin to a remote server
- build-and-copy: Build + deploy in one step
See LICENSE file for details.
Kamil Kosek (@kamilkosek)
See GitHub Releases for a complete changelog.