70 lines
2.7 KiB
Markdown
70 lines
2.7 KiB
Markdown
# Placard
|
||
|
||
[](https://github.com/sudolulo/jellyfin-placard/releases) [](https://jellyfin.org/) [](LICENSE) [](https://github.com/sponsors/sudolulo) [](https://ko-fi.com/sudolulo)
|
||
|
||
A Jellyfin plugin that bakes each **library's name onto a representative backdrop**,
|
||
matching Jellyfin's default library-card styling — so your home-screen library cards
|
||
look intentional and stop rotating.
|
||
|
||
|
||
|
||
## What it does
|
||
|
||
Jellyfin auto-generates a collage for libraries with no image and re-rolls it over
|
||
time. Placard replaces that with a static, labeled card per library:
|
||
|
||
- Picks a backdrop from a title in the library (highest-rated, random, or newest),
|
||
or a **pinned** title you choose.
|
||
- Composites the library name centered, in **Noto Sans**, with a soft drop shadow
|
||
over a light darkening scrim — the same look Jellyfin uses for its default covers.
|
||
- Sets the image through the internal provider API, so the change shows **without a
|
||
server restart**.
|
||
- Runs as a scheduled task (daily by default) and applies to new libraries too.
|
||
|
||
## Configuration
|
||
|
||
Dashboard → Plugins → **Placard**:
|
||
|
||
| Setting | Description |
|
||
|---|---|
|
||
| Enabled | Master on/off. |
|
||
| Backdrop source | Highest rated / Random / Newest title in each library. |
|
||
| Darkening | Scrim opacity (0–255); ~105 matches the default. |
|
||
| Label size | Label height as a percent of image height. |
|
||
| Pinned sources | One per line, `Library Name=Item Title`. Overrides the rule. |
|
||
|
||
Example pins:
|
||
|
||
```
|
||
Movies=The Dark Knight
|
||
Anime=Death Note
|
||
Collections=The Avengers Collection
|
||
```
|
||
|
||
Then run **Scheduled Tasks → Generate Placard library cards** (or wait for the daily run).
|
||
|
||
## Building
|
||
|
||
Requires the .NET 9 SDK (Jellyfin 10.11 targets net9.0).
|
||
|
||
```
|
||
dotnet build -c Release
|
||
```
|
||
|
||
Copy `bin/Release/net9.0/Jellyfin.Plugin.Placard.dll` (plus `meta.json`) into
|
||
`<jellyfin-config>/plugins/Placard_<version>/` and restart Jellyfin.
|
||
|
||
## Compatibility
|
||
|
||
- Jellyfin **10.11.x** (targetAbi `10.11.0.0`, net9.0).
|
||
- Uses the SkiaSharp bundled with the Jellyfin server.
|
||
|
||
## License
|
||
|
||
[GPL-3.0](LICENSE).
|
||
|
||
## Support
|
||
|
||
If Placard is useful to you, consider supporting development via
|
||
[GitHub Sponsors](https://github.com/sponsors/sudolulo) or [Ko-fi](https://ko-fi.com/sudolulo).
|