tallasafox / TitleCardMaker

Automated title card maker for Plex

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

logo TitleCardMaker

GitHub Develop Commits Discord Support

An automated title card maker for Plex.

Table of Contents

Description

TitleCardMaker is a Python program intended to be invoked via the command-line to automate the creation of title cards, which are image previews of an episode, for use in personal media services like Plex, Emby, or Jellyfin.

The actual image creation is done using the open-source and free image library called ImageMagick.

The Maker can be automated such that everything can be pulled without manual intervention (except for a few exceptions). Episode titles can be pulled from an instance of Sonarr, images and logos from TheMovieDatabase, and the maker can even automatically refresh Plex after new cards are created.

Getting Started

Read the Getting Started page on the Wiki.

Usage and Troubleshooting

Assuming you're using the default preference filename, invoking the Maker is as simple as:

$ pipenv run python3 main.py --run

For invocation and configuration details, read here.

If you have trouble getting the Maker working, or have a problem, create an issue on GitHub!

Examples

Below are some examples of title cards created automatically (when configured correctly) by the TitleCardMaker:

Mr. Robot S01E02 in the Standard card style

The Mandalorian S01E03 in the Star Wars card style

Demon Slayer: Kimetsu no Yaiba S03E10 in the Anime card style

Contributing

If you'd like to contribute - whether that's a suggested feature, a bug fix, or anything else - please do so on GitHub by creating an issue, or join the Discord. The best way for me to manage technical aspects of the project is on GitHub.

I plan on creating another repository for non-standard title card styles in the future.

Support

This has taken a pretty substantial amount of effort, so if you find this project useful you can support me on BuyMeACoffee, or become a GitHub sponsor - I would really appreciate it!

About

Automated title card maker for Plex

License:MIT License


Languages

Language:Python 99.8%Language:Dockerfile 0.2%