Skip to content

Switching from Plex-Meta-Manager to Kometa

You're using Plex-Meta-Manager now and need to switch to Kometa? Here's what you have to do:


These instructions are assuming that your existing config file is working with a recent [say 1.19 or newer] pre-rebrand Plex-Meta-Manager release.

If you are using Git:

  1. cd into the directory where you installed Plex-Meta-Manager
  2. retrieve the new code and reinstall requirements [see below for commands]. This is the same thing you'd do with any upgrade.
  3. change in any run command you use to For example: python --run.
  4. You're done.

The commands you need for step 2 are:

    git stash
    git stash clear
    git pull
    # activate your venv here if you use one and it is not already active
    python -m pip install -r requirements.txt

If you are using Docker:

  1. change the image you are using from meisnate12/plex-meta-manager:SOME_TAG to kometateam/kometa, You'll change this wherever it's specified in your situation, a docker run command, a docker compose file, some field in a NAS UI, wherever.
  2. If needed, rebuild the container however that happens in your context. docker compose up -d, clicking a button, whatever.
  3. You're done.

If you downloaded it as a zip file:

  1. uncompress the zip file
  2. cd into that directory and do the same setup you did initially (create a virtual environment, maybe, then install requirements. There's no way for us to know what you did when you set it up, so we can't give more specific instructions than that)
  3. copy the config directory from your Plex-Meta-Manager dir into this directory.
  4. change in any run command you use to For example: python --run.
  5. You're done.

Other things you can do if you wish:

Neither of these two things are required.

  1. change - pmm: in the config.yml file to - default:; the docs now use - default:, but either will work for the foreseeable future, so you do not need to do this. You may want to, and if so go ahead, but you do not have to.
  2. change the name of any directories you are using to "kometa". The app does not care about that part of the path. It only cares about the contents of the config directory, but it can be located anywhere. You do not have to change /some/path/to/Plex-Meta-Manager to /some/path/to/Kometa. Again, you may want to, and if so go ahead, but you do not have* to.

For example, this:

    remove_overlays: false
      - pmm: basic
      - pmm: imdb
Could, but does not have to, become:
    remove_overlays: false
      - default: basic
      - default: imdb