Support for setting Plex Square Art

[gritty pilot]

Are there any plans to add support for setting Plex's recently added Square Art? Some Mediux users are already adding square art assets to their sets (set as album art), and Plex allows local square art assets for Movies and TV Shows (https://support.plex.tv/articles/200220717-local-media-assets-tv-shows/). I'm one of the developers of Artwork Uploader for Plex (https://github.com/mscodemonkey/artwork-uploader-plex) and I've already added support in my dev build for this when the tool is set to update the assets directly in Plex. And I've also added support for downloading these assets to the local asset directory when using Kometa asset directory, but Kometa doesn't do anything with them at the moment (https://kometa.wiki/en/latest/kometa/guides/assets/), so hence my question. It would be great it this could be added so Kometa can pick up the downloaded assets in the asset directory and update them in Plex. Thanks!

[fleet pike]

Welcome @gritty pilot!

Someone from <@&938443185347244033> will assist when they're available.

Including meta.log from the beginning is a huge help. Type !logs for more information.

After attaching your log, do not forget to hit the green check boxes when prompted by our bot.

You can press the "Close Post" button above or type /close at any time to close this post.

[random epoch]

I have a branch here implementing square art support; I'm not sure why I stepped away from it. I'll review it.

[gritty pilot]

What's the name of the asset file it's going to look at? I've implemented it as square.ext.

It would be great if I didn't have to change it 😉

[random epoch]

That seems like the likely answer; matches the rest.

[gritty pilot]

Awesome

Thanks!

[17:31:16.530] 🔍 Spider-Noir (2026) • tallinex | Fetched 12 asset(s) from MediUX
[17:31:16.531] ⏩ Spider-Noir (2026) • tallinex | Skipping 11 asset(s) based on exclusions (0), filters (11) or errors (0). Processing 1 asset(s).
[17:31:17.471] ✅ Spider-Noir (2026) • tallinex | Square art saved at '/temp/TV Shows/Spider-Noir/square.jpg' in TV Shows
[17:31:17.471] ✔️ Spider-Noir (2026) • tallinex | 1 asset(s) processed in 2s • 1 asset(s) updated```

[random epoch]

Since you're using square art, if you want to try it out:
https://github.com/Kometa-Team/Kometa/pull/3144

[gritty pilot]

How can I test it?

[random epoch]

How are you running Kometa?

[gritty pilot]

docker

[random epoch]

There should be a docker image shortly

[gritty pilot]

Oh, great, thanks

[random epoch]

#testers-chat message

[lost adder]

looks like you dont have the tester role

[lost adder]

tester role added

[random epoch]

For Docker use the kometateam/kometa:square-art-support image to do your testing

[gritty pilot]

OK I have three shows with a downloaded square.jpg asset in their kometa asset directory. one is cape fear. i just ran it and got:

| (51/237) Cape Fear |
| Item: Cape Fear has an Overlay and will be updated when overlays are run |
| No Item Edits |

So it's not picking it up.

i'll report on the other two when the run ends (they're at the end)

OK, same thing

i ran python kometa.py -rl "TV Shows" -op from inside the docker container.

that's how i usually do it whenever i download new assets and don't want to wait for the scheduled run

|                                       Finished Libraries Run                                       |
|                                      Version: 2.3.1-build29.2                                      |
|      Start Time: 21:39:57 2026-06-05     Finished: 21:45:11 2026-06-05     Run Time: 0:05:14       |
|====================================================================================================|```

[random epoch]

I'll look into it

[gritty pilot]

any logs i can provide?

[lost adder]

Meta.log is the only log we ever really need