Plugin: EmbyIcons release.

[yocker 1247]

I have made this plugin for Emby named EmbyIcons.

yocksers/EmbyIcons: Displays icons on posters in Emby depending on audio and subtitle languages.

EmbyIcons enhances your Emby Server by overlaying informational icons directly onto media posters. Display language, codecs, resolution, ratings, and more at a glance with fully customizable profiles for different libraries.

---

Features

• Extensive Icon Support: Audio/subtitle languages, original language, audio channels, codecs (audio & video), HDR/Dolby Vision, resolution, frame rate, aspect ratio, parental ratings, community ratings (IMDb, Rotten Tomatoes, MDBList audience scores), custom tags, and favorite counts
• Multi-Profile System: Create distinct profiles and assign them to different libraries for complete customization
• Flexible Layout Control: Position icons in any corner with custom priority ordering and horizontal/vertical stacking
• Series & Collection Aggregation: Smart detection shows icons only when all episodes/items share the same property (with Lite Mode option for faster scans)
• Profile Import/Export: Backup and share your profile configurations
• Icon Manager: Identify used, unused, and missing icons in your collection
• Series Troubleshooter: Find episodes with inconsistent properties causing missing icons
• MDBList Integration: Display Rotten Tomatoes audience scores with a free API key
• Live Preview: See layout changes in real-time before saving
• Advanced Settings: Fine-tune cache sizes, performance, and memory usage

---

Installation

1. Place EmbyIcons.dll in your Emby Server's /plugins directory
2. Restart Emby Server
3. Navigate to Dashboard → Plugins → EmbyIcons to configure

---

Icon Naming Convention

Place your icon images in a folder on your server. Recommended: ~100x100px PNG with transparency. Supported formats: .png, .jpg, .webp, .gif, .bmp.

Icons use the format: prefix.name.png (case-insensitive)

Prefix	Type	Example
lang	Audio Language	lang.english.png
sub	Subtitle Language	sub.german.png
og	Original Language	og.japanese.png
ch	Audio Channels	ch.7.1.png, ch.stereo.png
ac	Audio Codec	ac.dts.png, ac.eac3.png
vc	Video Codec	vc.hevc.png, vc.av1.png
hdr	Video Format	hdr.dv.png, hdr.hdr.png
res	Resolution	res.4k.png, res.1080p.png
fps	Frame Rate	fps.24.png, fps.60.png
ar	Aspect Ratio	ar.16x9.png, ar.2.39x1.png
pr	Parental Rating	pr.pg-13.png, pr.tv-ma.png
tag	Custom Tag	tag.3d.png, tag.directors-cut.png
rating	Community Rating	rating.imdb.png
(none)	Rotten Tomatoes	t.tomato.png, t.splat.png
(none)	Popcorn-O-Meter	t.popcorn.png, t.spilledpopcorn.png, t.fresh.png
(none)	Favorite Count	heart.png

Note: Rotten Tomatoes Popcorn-O-Meter requires a free MDBList API key configured in Advanced Settings.

---

Configuration Overview

Settings Tab

• Global Settings: Set icon folder path, loading mode (Hybrid recommended), output format, quality, and logging
• Profile Management: Create, rename, delete, export, and import profiles
• Per-Profile Settings:
  • Assign profiles to libraries
  • Enable/disable icon types with custom alignment (corner), priority, and layout (horizontal/vertical)
  • Configure TV show/collection aggregation (Lite Mode, exclude Specials season, etc.)
  • Customize rating score background (shape, color, opacity)
  • Adjust icon size

Icon Manager Tab

Scan your library to identify missing, found, and unused icons. Perfect for organizing your icon collection.

Troubleshooter Tab

• Series Troubleshooter: Find episodes with inconsistent properties (resolution, codec, etc.) that prevent series-level icons
• Aspect Ratio Calculator: Get the exact icon filename for custom aspect ratios
• Memory Usage: View plugin memory statistics

Advanced Tab

Fine-tune cache sizes, expiration times, concurrency, and MDBList API key. Default values work for most users.

Edited February 13 by yocker
Notes amended

[Luke 42077]

Hi, thanks for sharing.

[yocker 1247]

New version up with some fixes inc. working in the beta and not having to restart the server for new settings to work.

Enjoy!

[yocker 1247]

New release with a lot of optimizations and speed increases.

@Neminem
If you could check this one out i would greatly appreciate it.
Sound be a good improvement.

@ebr
Sorry for bothering you.
I can't seem to get the setting to to apply after a save no matter what i try, only a server restart applies the settings.
Is this a limitation of Emby for third party plugins?

Edited May 13, 2025 by yocker

[Luke 42077]

No it’s not a limitation. Other plugins don’t require restarting the server after changing settings.

[Neminem 1516]

2 hours ago, yocker said:

New release with a lot of optimizations and speed increases.

@Neminem
If you could check this one out i would greatly appreciate it.
Sound be a good improvement.

Sure I will test later today.

I will test both Release and Beta server

[yocker 1247]

5 hours ago, Luke said:

No it’s not a limitation. Other plugins don’t require restarting the server after changing settings.

I've tried everything but nothing works. Have a theory that old cached images are being used so it won't redraw the icons on to them.

But thanks for confirming that it's not a limitation, means i just need to keep trying.

Never mind that, i'm an idiot. Forgot i tried to cache some settings for optimization.
Made it work now!

 

Edited May 13, 2025 by yocker

[yocker 1247]

New release up.

Fixed: Settings no longer require a server restart to work.

That should be a fully finished plugin for now, can't see anything else being wrong or any more optimizations being made.
At least until i come up with more i want it to do.

[Neminem 1516]

Testing v1.5 

Release server 4.8.11 : Testet ok

Beta server 4.9.53 : Tested ok

Love the new speed bust, and the ability to select mkv, mp4 and other file formats

[Neminem 1516]

Now I just need to edit those movies with audio language taget as undefined

But now I can see which it is, as Emby does not have the ability to filter on that

 

[yocker 1247]

New release.
Fixed: Minor optimizations, should speed things up a tiny little bit more.

@Neminem
Many thanks again and happy to see you can use the plugin! 
My users are also pretty happy that they now can quickly scan the posters and see what has the right language and/or subtitles.

 

[yocker 1247]

New release with more optimizations and speed increase.
Should be all the optimization that can be done and all the speed i can squeeze out of this plugin.

Time for some sleep i think.

[Neminem 1516]

Testing v1.7

Release server 4.8.11 : Testet ok

Beta server 4.9.53 : Tested ok

Wow its really fast now

[Luke 42077]

Bear in mind this will likely cause servers that don't run Skia to crash. What's needed is a modular implementation that will vary depending on what image processor(s) the server has available. so that will be needed if you intend to get this into the catalog, but for forum distribution you can obviously do whatever.

[yocker 1247]

1 hour ago, Luke said:

Bear in mind this will likely cause servers that don't run Skia to crash. What's needed is a modular implementation that will vary depending on what image processor(s) the server has available. so that will be needed if you intend to get this into the catalog, but for forum distribution you can obviously do whatever.

Thank you for pointing it out, i thought Skia was part of all Emby distributions.

I have no plans of putting it in the catalog, i'm sure CoverArt and Iconic will support these features one day so my plugin won't be needed any more.

[Luke 42077]

Quote

i thought Skia was part of all Emby distributions.

Mostly. It's mainly older devices and architectures that can't run it.

[yocker 1247]

1 minute ago, Luke said:

Mostly. It's mainly older devices and architectures that can't run it.

Okay, i see no real reason to do anything about it then.
Though a small warning in the readme might be in order. From what version did Emby use it?

[Luke 42077]

2 minutes ago, yocker said:

Okay, i see no real reason to do anything about it then.
Though a small warning in the readme might be in order. From what version did Emby use it?

It's nothing to do with version number. Some platforms are still built without skia now on the latest versions. I would say just mention that it's for x64 and arm64 architectures only and I think that will be good.

[yocker 1247]

3 minutes ago, Luke said:

It's nothing to do with version number. Some platforms are still built without skia now on the latest versions. I would say just mention that it's for x64 and arm64 architectures only and I think that will be good.

Many thanks! I will do that.

[yocker 1247]

New version out.

Fixed: Now works with all languages.
Had forgotten to remove some old test code for language fallback in case people misnamed the icons.

[yocker 1247]

New version out.

Added support for 2 letter language codes.
Added some example icons - Shoutout to @Craggles really hope you are okay with this, otherwise i will remove them instantly and give you an apology!!

[Craggles 58]

40 minutes ago, yocker said:

Added some example icons - Shoutout to @Craggles really hope you are okay with this, otherwise i will remove them instantly and give you an apology!!

I am VERY ok for this.

[yocker 1247]

19 minutes ago, Craggles said:

I am VERY ok for this.

Many many thanks!!

[yocker 1247]

New version up.
Added setting to configure what external subtitles the plugin should look for.

Like .str, .ass and so on.

[keitaro26 22]

Is there any way to apply the icon to the series posters on TV shows instead of the episodes themselves?