/Anime-Collections-PMM

Custom Anime Collections and Artwork for Plex Meta Manager

Evil Tactician's Anime Collections

Anime Collections based on MAL Genres

Included

  • config.yml
  • Anime.yml
  • Custom Artwork
  • Photoshop Template

Preview:
Anime

I am going to assume you've followed the guides for installing Plex Meta Manager for your platform.

config.yml

You can either use my config.yml, or you can use it as a cheatsheet for the elements you need in your own.
Note that mine only contains the sections required for Anime Collections to work.
Don't forget to configure the plex:, tmbd: and mal: sections with your details and API keys. There are links in the file to guides for those.

Anime.yml

This is the configuration file for the Anime Collections.

templates:
  MAL Genre:
    mal_genre:
      genre_id: <<genre_id>>
    collection_order: alpha
    collection_mode: hide
    sync_mode: sync

The above is the template for the Genre Collections.
If you wish to change the collection_mode, collection_order or sync_mode, please do so here. It will apply to all Genre Collections.

  MAL User:
    sort_title: ~<<collection_name>>
    mal_userlist:
      username: <<username>>
      status: plan_to_watch
      sort_by: title
      limit: 500
    collection_order: alpha
    collection_mode: hide
    sync_mode: sync 

The above is the template for the MAL "Plan to Watch" Collections below.

  Collection1: # Replace Username1 with a valid MAL Username
    template: { name: MAL User, username: Username1 }
  Collection2: # Replace Username2 with a valid MAL Username
    template: { name: MAL User, username: Username2 }

Above is where you specify collections for individual users, based on their MAL profile's "Plan to Watch" list.
Replace Collection1: with whatever you want the Collection to be called in Plex.
Replace Username1 with the exact username of the MAL profile you wish to use.

Repeat for as many users as you want - just copy and paste more entries.

If you don't wish to use these, simply delete them from the file.

  Donghua:
    collection_order: alpha
    sync_mode: sync
    plex_search:
      all:
        audio_language: zh
        title.not: aggretsuko
  Mobile Suit Gundam:
    collection_order: alpha
    sync_mode: sync
    plex_search:
      all:
        title: Gundam

The above creates the Donghua and Mobile Suit Gundam collections based on a Plex Search. Similar to advanced filters within Plex itself.

  Unmatched:
    plex_collectionless:
       exclude: Test
    sort_title: ~_Unmatched
    collection_order: alpha

The above (at the very bottom of the file) creates a collection named "Unmatched" which will contain every Anime in your library which PMM wasn't able to add to the MAL Genres. I use this myself to see which Anime PMM couldn't map.
PMM maps via external resources and it sometimes takes a while for those resources to update as they rely on human intervention. It doesn't necessarily mean there is something wrong with your library or config - it's like that those Anime haven't been mapped.

Again, if you don't want this - just delete those lines.

  Erotica:
    template: { name: MAL Genre, genre_id: 49 }
  Hentai:
    template: { name: MAL Genre, genre_id: 12 }

Finally, I call the above out specicially. If you don't have any Erotica and Hentai, you can speed up your script running time by removing these lines. It'll save you a minute.
Again as with any others, if you don't have any, the collections won't be created if your config.yml is set to require a minimum of 1 show for collections.

Custom Artwork

The posters from the preview can be found in the Assets folder. You can upload the entire folder "as is" to the same directory where your config.yml and Anime.yml files are located. Please note that the names of each poster need to match the names of the collections in your Anime.yml file. If you rename any collection, you'll have to rename the poster accordingly!

If you wish to display custom posters for your MAL "Plan to Watch" Collection(s), you'll need to add posters in the Assets folder with the name of each collection as well.

For example, if your MAL Profile Collection is called "Plan to Watch", you would need to add "/Assets/Plan to Watch.png"

PSD Template

There is a PSD Template (Photoshop) included if you wish to make MAL Profile Collections in the same style. This template can also be used to make new Collection posters in the same style, just untick the "Plan to Watch" layer and make sure your background image spans the whole frame.

Testing / First Run

If you wish for PMM to do a one-off run instead of waiting for the daily schedule:

  1. Ensure the PMM container is running
  2. Open the terminal
  3. Run python plex_meta_manager.py -r Press CTRL-C if you want it to stop before it finishes.

For me it takes approximately 16 minutes.

Special Thanks

JJJonesJr33 - Original Base Anime.yml & Feedback
Fribb - Creator of https://github.com/Fribb/anime-lists, helped me track down some mapping issues
Sohjiro - Creator of Plex Meta Manager

There was quite a bit of work involved in this - and you're welcome to use my assets and templates as you see fit as long as you give credit if you re-distribute them anywhere or include them in another project.

If you wish to say thanks, you can buy me a coffee or wave on Discord.