New Badge Overlay plugin

[Amanade3 52]

I created a plugin that adds customizable “New” badges, banners, or ribbons to library items based on release date or date added.

It works with movies, TV series, and episodes, making it easier to highlight newly released or recently added content in your library.

Give it a try and let me know what you think.

Here are some screenshots:

EmbyNewOverlay.dll

[sh0rty 746]

This is really nice and works well! Thanks.

Few suggestions:
- It would be nice to have a button in plugin settings to clear image cache to force an image redraw after changing settings (perhaps @yockercan help out with an appropriate code snippet from Embyicons release)

- I would like to have an option to set up years for badges additionally to the "Days since ..." fields, e.g. I would like to be able to set up 2026 instead of x days since item premiere /release date

Keep up the good work!

Edited May 27 by sh0rty

[Amanade3 52]

1 hour ago, sh0rty said:

- It would be nice to have a button in plugin settings to clear image cache to force an image redraw after changing settings (perhaps @yockercan help out with an appropriate code snippet from Embyicons release)

- I would like to have an option to set up years for badges additionally to the "Days since ..." fields, e.g. I would like to be able to set up 2026 instead of x days since item premiere /release date

Keep up the good work!

Well thanks for the feedback. This is just the first release and there will be improvement and new features in the future.

[Amanade3 52]

v1.0.0

Initial release.

• NEW badge overlay for Movies, Series, and Episodes.
• Three detection modes: Date Added, Release Date (days window), and New Season.
• Configurable badge style (Ribbon, Badge, Banner), position, size, colour, opacity, and labels per item type.
• Priority order: Release Date > New Season > Date Added.
• Automatic cache invalidation via daily cache key buckets.

[Amanade3 52]

V1.1.0

What's new

• Fixed ribbon text appearing mirrored/flipped on 3 corners.
• Implemented year-based filtering for 'New' badges.
• Added Tag Badge rules — assign a custom label and colour to any Emby tag, (overrides the default date badge).

 

EmbyNewOverlay.dll

Edited May 28 by Amanade3

[sh0rty 746]

4 hours ago, Amanade3 said:

V1.1.0

What's new

• Fixed ribbon text appearing mirrored/flipped on 3 corners.
• Implemented year-based filtering for 'New' badges.
• Added Tag Badge rules — assign a custom label and colour to any Emby tag, (overrides the default date badge).

 

EmbyNewOverlay.dll 295 kB · 5 downloads

Year based filtering works like a charm. Thanks!

[roand7802 1]

Hello, I’m new to this.

I wanted to test the extension, so I added it to my server, modified the badge names, and saved the configuration. What should I do next to apply the badges to my content?

I thought it worked through a scheduled task. I tried refreshing the metadata for a series, but nothing shows up. I also added a new episode, but still no success.

[sh0rty 746]

7 hours ago, roand7802 said:

Hello, I’m new to this.

I wanted to test the extension, so I added it to my server, modified the badge names, and saved the configuration. What should I do next to apply the badges to my content?

I thought it worked through a scheduled task. I tried refreshing the metadata for a series, but nothing shows up. I also added a new episode, but still no success.

If you're using a Browser, it'S showing cached images. Try Ctrl+Shift+R. To delete image cache on server side, I use Yockers EmybIcons plugin anyways and it has a Delete image cache option in Troubleshooting section of the plugin setting.

[roand7802 1]

After doing a lot of troubleshooting, I found that the issue was not related to the extension itself. The root cause was that my Emby Server installation was missing the libSkiaSharp.so library (or one of its required dependencies).

Once I identified and fixed that problem, the extension started working correctly and the badges were generated as expected.

Hopefully this information helps anyone who runs into the same issue.

[howllor 33]

Great plugin!

Would love if it could apply to music libraries too!

Edited Friday at 08:38 PM by howllor

[WDPR4100 15]

On 5/28/2026 at 1:45 PM, sh0rty said:

Year based filtering works like a charm. Thanks!

Error ImageProcessor: Error in GetConfigurationCacheKey System.ArgumentOutOfRangeException: The UTC time represented when the offset is applied must be between year 0 and 10,000. (Parameter 'offset') at System.DateTimeOffset..ctor(DateTime dateTime) at EmbyNewOverlay.Enhancer.NewBadgeEnhancer.GetConfigurationCacheKey(BaseItem item, ImageType imageType)

[Amanade3 52]

7 hours ago, WDPR4100 said:

Error ImageProcessor: Error in GetConfigurationCacheKey System.ArgumentOutOfRangeException: The UTC time represented when the offset is applied must be between year 0 and 10,000. (Parameter 'offset') at System.DateTimeOffset..ctor(DateTime dateTime) at EmbyNewOverlay.Enhancer.NewBadgeEnhancer.GetConfigurationCacheKey(BaseItem item, ImageType imageType)

As far as i know if you put the right year like 2026 it filters out movies and shows from the year 2026 and apply the badges over them. Or you can set it to just 0 and use the other options. Can you tell me which system are you using?

Edited Saturday at 08:28 AM by Amanade3

[Amanade3 52]

11 hours ago, howllor said:

Would love if it could apply to music libraries too!

I will try... for future updates

[Eigeplackter 107]

Like the plugin. What I'm missing is a badge in movies library, when a "New Movie" is part of a collection.

[Amanade3 52]

51 minutes ago, Eigeplackter said:

Like the plugin. What I'm missing is a badge in movies library, when a "New Movie" is part of a collection.

I don't quite get your question.. but if you are implying that a movie didn't get a badge if it is in a collection.. well i tried adding some movies in a collection and the badge still shows up like in the screenshot. May be the issue is, your browser loads the old cached image. Try hard refreshing browser if you are using chrome ctrl + Shift +R. 

[Eigeplackter 107]

I‘ll try to explain.

See I have this movie, which has the correct bange displayed on startpage section latest movies:

 

The corresponding boxset/collection in the movies library does not indicate this state with a badge.

The movie inside does have the badge

 

 

It‘s not a bug, just a suggested enhancement. I have on clue if that‘s even possible.

Something like a badge saying new movie inside.

 

 

 

[Amanade3 52]

Oh i see what you mean now...I don't think it is possible. I don t think a collection metadata has a production year and premiere date. So the plugin cant apply the badge on the collection set poster. I will see if it is possible to apply a badge if one of the content contains New movie badge.

[Amanade3 52]

EmbyNewOverlay.dll

V1.1.0.1

What's new

• Added item type and expiry date for tag rule.

[Amanade3 52]

New Update 1.2.0 is coming with some new features including overlay for music library and collection (box-set). It will be ready once I finished it. 

Edited yesterday at 11:56 AM by Amanade3

[howllor 33]

Looks great!

Just had a though, would it be possible to add support for emojis in the badge text? 

[Amanade3 52]

New Release

V 1.2.0

• Added overlay support for collections and box-sets.

• Added overlay support for music albums (works only with downloaded artwork from metadata provider or manually uploaded artwork).

• Upgraded the config-Page UI.

• Introduced custom badge colors alongside separate opacity controls for individual badges and tag rules.

EmbyNewOverlay.dll

[Eigeplackter 107]

Replaced old .dll, restarted server and did a library scan.

No Badges on box-set/collection 

[Amanade3 52]

1 hour ago, Eigeplackter said:

Replaced old .dll, restarted server and did a library scan.

No Badges on box-set/collection 

The issue is collection has a metadata separate from the movies inside it so you have to make sure the parameters in the metadata matches the configuration in the plugin. Let me show you in my screenshots. In your collection right click on -Edit metadata> select release date and put recent date and new collection tag will show up. let me know this fixes the issue

  

Edited 1 hour ago by Amanade3