Welcome to TitleCardMaker

TitleCardMaker (TCM) is a program and Docker container written in Python that automates the creation of customized Title Cards for use in personal media server services like Plex, Jellyfin, or Emby. This is a self-hosted tool - meaning that it is installed and run on your computer.

What is a Title Card?

A Title Card is a thumbnail image for an Episode of television that can be used to add a unique look within a personal media server like Plex, Emby, or Jellyfin. Some Series have "official" Title Cards featured in the Episode itself, but TCM specializes in creating and customizing "unofficial" Title Cards. The following Cards have all been designed by me, and were created with TitleCardMaker:

Download the Code

While the TCM Web UI is under active development, it is only accessible to project Sponsors. If you are interested, sponsor on GitHub for access.

Installation and startup instructions are here.

Getting Started

Detailed Tutorial

For more detailed tutorials that take you step-by-step through the installation and setup of TitleCardMaker, continue to the Getting Started tutorial.

TitleCardMaker is designed to for an easy "out of the box" setup. The basic steps are as follows:

Install TitleCardMaker (via Docker or locally).
Set up your Connections to your other services - such as Sonarr, TMDb, TVDB, Plex, Emby, Jellyfin, or Tautulli.
Start adding Series to TitleCardMaker - this can be done manually, or with Syncs.
Customize the look and style of Title Cards to your liking.

Updating

After the initial install, if you would like to update to the latest version of TCM, then you need to do the following:

Docker Compose Docker Non-Docker

Navigate to your original install directory - like so:
```
cd ~/My/Install/Diretory/TitleCardMaker-WebUI
```
Pull and relaunch the container:
```
docker compose up --pull always -d
```

Navigate to your original install directory - like so:
```
cd ~/My/Install/Diretory/TitleCardMaker-WebUI
```
Remove the old container.
```
docker container rm TitleCardMaker
```

Pull the latest image (change latest to develop if desired).

docker pull "ghcr.io/titlecardmaker/titlecardmaker-webui:latest"

Recreate the container by running your original docker run command (see here).

Navigate to your original install directory - like so:
```
cd ~/My/Install/Diretory/TitleCardMaker-WebUI
```
Switch to the branch you would like to be on - this is main or develop:
```
git checkout main
```
Pull in the newest changes:
```
git pull
```

Re-launch TitleCardMaker.

uv run uvicorn app-main:app --host "0.0.0.0" --port 4242