Jump to content

Recommended Posts

DarkKniyt (John)
Posted

Question.

In the section "Filename-based icons", is it possible to use a NOT CONTAINS in the "Keyword" section.

Example.
NOT EnglishOnly

Thanks.

Great plug-in by the way!

  • Like 1
yocker
Posted
3 hours ago, DarkKniyt (John) said:

Question.

In the section "Filename-based icons", is it possible to use a NOT CONTAINS in the "Keyword" section.

Example.
NOT EnglishOnly

Thanks.

Great plug-in by the way!

The plugin has no exclude function at the moment.
I can look into adding it in the future but i'm on a kind of summer break from the plugins so will take a little while before i get to it.

Thank you! :) 

DarkKniyt (John)
Posted
1 hour ago, yocker said:

The plugin has no exclude function at the moment.
I can look into adding it in the future but i'm on a kind of summer break from the plugins so will take a little while before i get to it.

Thank you! :) 

Thank You!

  • Like 1
majorsl
Posted

I just installed this plugin from the catalog. I have not had a previous version installed, so maybe I'm missing something, but I cannot get it to work.

I installed it, restarted Emby, went to the plugin and created a new profile (Default).  I assigned collections and went through some settings to select the options I want.  They show up on the Live Preview.  I hit save and went back to my Home Screen.  No changes.  I went to Troubleshooter and cleared all the caches.  Restarted Emby and still no changes.  Went to Icon Manager, scanned, and the Stats show about what I'd expect for my media library.

I see this in the logs when I enabled Debug Logging:
 

*** Error Report ***
Version: 4.9.5.0
Command line: /opt/emby-server/system/EmbyServer.dll -programdata /var/lib/emby -ffdetect /opt/emby-server/bin/ffdetect -ffmpeg /opt/emby-server/bin/ffmpeg -ffprobe /opt/emby-server/bin/ffprobe -restartexitcode 3 -updatepackage emby-server-deb_{version}_amd64.deb
Operating system: Linux version 7.0.2-6-pve (build@proxmox) (gcc (Debian 14.2.0-19) 14.2.0, GNU ld (GNU Binutils for Debian) 2.44) #1 SMP PREEMPT_DYNAMIC PMX 7.0.2-6 (2
OS/Process: x64/x64
Framework: .NET 8.0.25
Runtime: opt/emby-server/system/System.Private.CoreLib.dll
Processor count: 2
Data path: /var/lib/emby
Application path: /opt/emby-server/system
System.InvalidOperationException: System.InvalidOperationException: ValueFactory attempted to access the Value property of this instance.
at System.Lazy`1.ViaFactory(LazyThreadSafetyMode mode)
at System.Lazy`1.ExecutionAndPublication(LazyHelper executionAndPublication, Boolean useDefaultConstructor)
at System.Lazy`1.CreateValue()
at EmbyIcons.Services.ProfileManagerService.GetProfileForPath(String path)
at EmbyIcons.Services.ProfileManagerService.GetProfileForItem(BaseItem item)
at EmbyIcons.Plugin.GetProfileForItem(BaseItem item)
at EmbyIcons.EmbyIconsEnhancer.Supports(BaseItem item, ImageType imageType)
at Emby.Drawing.ImageProcessor.GetSupportedEnhancers(BaseItem item, ImageType imageType)
Source: System.Private.CoreLib
TargetSite: Void ViaFactory(System.Threading.LazyThreadSafetyMode)

I installed CoverArt after removing EmbyIcons and it's overlays work, if that matters.

yocker
Posted
1 hour ago, majorsl said:

I just installed this plugin from the catalog. I have not had a previous version installed, so maybe I'm missing something, but I cannot get it to work.

I installed it, restarted Emby, went to the plugin and created a new profile (Default).  I assigned collections and went through some settings to select the options I want.  They show up on the Live Preview.  I hit save and went back to my Home Screen.  No changes.  I went to Troubleshooter and cleared all the caches.  Restarted Emby and still no changes.  Went to Icon Manager, scanned, and the Stats show about what I'd expect for my media library.

I see this in the logs when I enabled Debug Logging:
 

*** Error Report ***
Version: 4.9.5.0
Command line: /opt/emby-server/system/EmbyServer.dll -programdata /var/lib/emby -ffdetect /opt/emby-server/bin/ffdetect -ffmpeg /opt/emby-server/bin/ffmpeg -ffprobe /opt/emby-server/bin/ffprobe -restartexitcode 3 -updatepackage emby-server-deb_{version}_amd64.deb
Operating system: Linux version 7.0.2-6-pve (build@proxmox) (gcc (Debian 14.2.0-19) 14.2.0, GNU ld (GNU Binutils for Debian) 2.44) #1 SMP PREEMPT_DYNAMIC PMX 7.0.2-6 (2
OS/Process: x64/x64
Framework: .NET 8.0.25
Runtime: opt/emby-server/system/System.Private.CoreLib.dll
Processor count: 2
Data path: /var/lib/emby
Application path: /opt/emby-server/system
System.InvalidOperationException: System.InvalidOperationException: ValueFactory attempted to access the Value property of this instance.
at System.Lazy`1.ViaFactory(LazyThreadSafetyMode mode)
at System.Lazy`1.ExecutionAndPublication(LazyHelper executionAndPublication, Boolean useDefaultConstructor)
at System.Lazy`1.CreateValue()
at EmbyIcons.Services.ProfileManagerService.GetProfileForPath(String path)
at EmbyIcons.Services.ProfileManagerService.GetProfileForItem(BaseItem item)
at EmbyIcons.Plugin.GetProfileForItem(BaseItem item)
at EmbyIcons.EmbyIconsEnhancer.Supports(BaseItem item, ImageType imageType)
at Emby.Drawing.ImageProcessor.GetSupportedEnhancers(BaseItem item, ImageType imageType)
Source: System.Private.CoreLib
TargetSite: Void ViaFactory(System.Threading.LazyThreadSafetyMode)

I installed CoverArt after removing EmbyIcons and it's overlays work, if that matters.

There is a new beta in the catalog (v5.52.9), see if that version works for you.

majorsl
Posted

Still no luck, but I'm seeing these in the logs.  No idea why it says my collections are empty - they definitely are not.

2026-05-21 19:14:20.926 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.

2026-05-21 19:14:38.254 Warn Plugin: [EmbyIcons] Collection 'DC TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.261 Warn Plugin: [EmbyIcons] Collection 'Full House Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.272 Warn Plugin: [EmbyIcons] Collection 'Marvel TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.287 Warn Plugin: [EmbyIcons] Collection 'Star Wars TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.287 Warn Plugin: [EmbyIcons] Collection 'Stargate TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.290 Warn Plugin: [EmbyIcons] Collection 'Transformers TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.292 Warn Plugin: [EmbyIcons] Collection 'Walking Dead TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.294 Warn Plugin: [EmbyIcons] Collection 'The X-Files Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.

 

yocker
Posted
15 minutes ago, majorsl said:

Still no luck, but I'm seeing these in the logs.  No idea why it says my collections are empty - they definitely are not.

2026-05-21 19:14:20.926 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.
2026-05-21 19:14:20.927 Warn Plugin: [EmbyIcons] Library path Trie is null, cannot check library restrictions.

2026-05-21 19:14:38.254 Warn Plugin: [EmbyIcons] Collection 'DC TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.261 Warn Plugin: [EmbyIcons] Collection 'Full House Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.272 Warn Plugin: [EmbyIcons] Collection 'Marvel TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.287 Warn Plugin: [EmbyIcons] Collection 'Star Wars TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.287 Warn Plugin: [EmbyIcons] Collection 'Stargate TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.290 Warn Plugin: [EmbyIcons] Collection 'Transformers TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.292 Warn Plugin: [EmbyIcons] Collection 'Walking Dead TV Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.
2026-05-21 19:14:38.294 Warn Plugin: [EmbyIcons] Collection 'The X-Files Collection' (ID: 00000000-0000-0000-0000-000000000000) is empty. Cannot determine library profile.

 

The plugin does not support collections for TV series, at least for now.
Is that the only place it doesn't show any icons for you?

The "Trie is null" is a problem i need to look into though.

youcinez
Posted (edited)
On 5/12/2025 at 10:05 AM, yocker said:

EmbyIcons, in catalog under general.

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


image.png.90d38fc681e012f86be2f3bcf2ebf61c.png

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

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

Advanced Tab

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

Great plugin! Custom icons make a huge difference for the overall Emby experience on Android TV.

Speaking of Android TV visual experience — we have been testing different Android TV Box processors for 4K AV1 streaming performance alongside Emby. The hardware decoder support varies dramatically between chips.

Amlogic S928X handles 4K AV1 at 60fps smoothly with Emby — no dropped frames or stuttering. MediaTek MT8695 performs similarly well. However Amlogic S905X4 struggles with 4K AV1 content above 30fps and thermal throttles during extended playback sessions.

For anyone running Emby on Android TV with 4K AV1 content, choosing the right processor makes a significant difference. [redacted] 

Edited by GrimReaper
Link removed
  • Disagree 1
yocker
Posted (edited)

@youcinezI don't like ads, specially not ones that disguise them self as normal conversation! 

To anyone reading this, i suggest staying off the website he linked.

Edit:
Thank you @GrimReaper

Edited by yocker
  • Like 3
majorsl
Posted

No, it still isn't working anywhere for me.  I tried creating a new profile and left the settings (except for choosing my movie library) as default so I should have overlays with the default items.  That didn't work either.

yocker
Posted
42 minutes ago, majorsl said:

No, it still isn't working anywhere for me.  I tried creating a new profile and left the settings (except for choosing my movie library) as default so I should have overlays with the default items.  That didn't work either.

Please supply me with a full envy log with debug enable in both Emby and the plugin and I will look at it asap

majorsl
Posted
25 minutes ago, yocker said:

Please supply me with a full envy log with debug enable in both Emby and the plugin and I will look at it asap

I got it working.  Thank you for the "hint". Enabling Emby's debug log led me to invalid library paths that it must have been choking on once I looked through it before posting it.  When I migrated away from Docker months ago, my Movies & TV folder paths still had the ones I was using with Docker and the new paths (I forgot to delete the old ones).  Once I did that, restarted Emby, all the overlays started working right away.

yocker
Posted

Nice! Happy to hear it is working now :)

 I've added the show collections to the to of the Todo list, can't promise when it's done though.

majorsl
Posted

I'm looking at doing some custom icons or a set, and I'm looking at that crazy large list of aspect ratios it tells me that I'm missing in the plugin.  Some are obviously "real" but a lot are just pixel dimentions.  Like, 80057x60240 is insanely huge.  I might just dump them into an AI and have it spit out the nearest "real" aspect ratio or convert them into decimal ratio.  I know I'll never use 'em, but if I ever decide to share a set I'd like it somewhat complete.

yocker
Posted
5 minutes ago, majorsl said:

I'm looking at doing some custom icons or a set, and I'm looking at that crazy large list of aspect ratios it tells me that I'm missing in the plugin.  Some are obviously "real" but a lot are just pixel dimentions.  Like, 80057x60240 is insanely huge.  I might just dump them into an AI and have it spit out the nearest "real" aspect ratio or convert them into decimal ratio.  I know I'll never use 'em, but if I ever decide to share a set I'd like it somewhat complete.

The plugin will automatically snap the aspect ratios to the nearest commonly known and used ratio.
Here is a list:

16/9 ≈ 1.778  -   16x9
4/3 ≈ 1.333   -  4x3
21/9 ≈ 2.333  -  21x9
1.85   -  1.85x1
2.35   -  2.35x1
2.39   -  2.39x1
2.40   -  2.40x1

80057x60240 would be 4/3 i believe.

majorsl
Posted
3 minutes ago, yocker said:

The plugin will automatically snap the aspect ratios to the nearest commonly known and used ratio.
Here is a list:

16/9 ≈ 1.778  -   16x9
4/3 ≈ 1.333   -  4x3
21/9 ≈ 2.333  -  21x9
1.85   -  1.85x1
2.35   -  2.35x1
2.39   -  2.39x1
2.40   -  2.40x1

80057x60240 would be 4/3 i believe.

Awesome. Would that mean I still need a badge for each or just the ones above?  I assumed when I hit "scan library and icons" in the plug in, I'd need a .png for each missing one listed.  Is that just bad metadata coming from my files or an embedded list in the plug-in?

yocker
Posted
10 minutes ago, majorsl said:

Awesome. Would that mean I still need a badge for each or just the ones above?  I assumed when I hit "scan library and icons" in the plug in, I'd need a .png for each missing one listed.  Is that just bad metadata coming from my files or an embedded list in the plug-in?

The plugin already supplies for:
16x9
2.40x1
4x3

You will need to supply these to the user custom icons folder to cover all the ratios:

ar.21x9.png
ar.1.85x1.png
ar.2.35x1.png
ar.2.39x1.png

One day i really need to finish the embedded icons collection.
 

yocker
Posted

New beta out (v5.53.0.0)
Added support for TV series icons in collections.

On my summer break but was bored out of my mind this weekend so worked on this.
Please report any bugs you might find to me.

  • Thanks 1
JsinFate
Posted

I upgraded to Emby Server Beta: 4.10.0.13 earlier this morning, then installed EmbyIcons. When I restarted the server, it never came back up. I manually deleted the .dll file and even tried reinstalling the latest Beta and regressing to latest official release, but Emby refuses to start. 

The log file shows hundreds of entries:
2026-05-27 11:24:58.888 Debug Plugin: [EmbyIcons] Populating library path cache using Trie.

After failing to get Emby started for over an hour, I noticed that in the directory: AppData\Roaming\Emby-Server\programdata\plugins  there was another DLL named embyicons.dll

I deleted it, closed Emby and renamed my backup Emby folder and was finally able to start Emby using the latest Beta version. 
 

Thank you.

Neminem
Posted

Is this plugin even suppose to work with beta server 🤔

MediaIntelNUC
Posted
6 minutes ago, Neminem said:

Is this plugin even suppose to work with beta server 🤔

I have used it with Beta Server for the last 8 month-ish and it have worked flawless through several beta updates👍

 

  • Like 1
Neminem
Posted

@MediaIntelNUC

Did you update you server to 4.10.0.13?

I don't use the plugin on Beta, so never tried.

  • Like 1
PeteGul
Posted

Had to delete the plugin for the new betaserver to work. The server just will not start with this in the plugin folder. Windwos.

Has worked on everyone until now 🙂

Kindly, and thanks for a awsome plugin.

yocker
Posted
3 hours ago, JsinFate said:

I upgraded to Emby Server Beta: 4.10.0.13 earlier this morning, then installed EmbyIcons. When I restarted the server, it never came back up. I manually deleted the .dll file and even tried reinstalling the latest Beta and regressing to latest official release, but Emby refuses to start. 

The log file shows hundreds of entries:
2026-05-27 11:24:58.888 Debug Plugin: [EmbyIcons] Populating library path cache using Trie.

After failing to get Emby started for over an hour, I noticed that in the directory: AppData\Roaming\Emby-Server\programdata\plugins  there was another DLL named embyicons.dll

I deleted it, closed Emby and renamed my backup Emby folder and was finally able to start Emby using the latest Beta version. 
 

Thank you.

AppData\Roaming\Emby-Server\programdata\plugins
Is where the plugin is supposed to be in the Emby Windows version.
 

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
×
×
  • Create New...