Since v5 this is a great step into the future of tinyMediaManager, you can not inline upgrade your v4 installation to v5. You need to install a clean copy of tinyMediaManager v5 to your system and migrate the data from your v4 installation.

Please review the increased system requirements for tinyMediaManager v5!

Depending on your needs, you may to choose between the installable/user folder version (Windows, macOS and Linux) or the portable/embedded version (Windows and Linux). The main difference between those two versions is:

  • Installable/user folder version: in this version, all your data is stored in a centralized folder in your user profile which decouples the data from tinyMediaManager itself. Those folders are:
    • Windows: C:\<username>\AppData\Roaming\tinyMediaManager
    • macOS: ~/Library/Application Support/tinyMediaManager
    • Linux: ~/.local/share/tinyMediaManager
  • Portable/embedded version: in this version all your data is stored within the same folder as tinyMediaManager itself.

Which version should I use?

By default the installable/user folder version might be the right version for you, unless you plan to use different tinyMediaManager instances. If you plan to use separate tinyMediaManager instances (e.g. your library is too big for a single instance), you should use the portable version. You will get the latest version of tinyMediaManager at

For macOS users: Since we cannot offer a portable version any more (this would break the signature and notarization), you need to create a special start link. See the following blog post for more details.

For Linux users: We only ship the installable/user folder version. If you want to create a portable version, just delete the file .userdir in the tinyMediaManager folder to switch to the portable mode.

To import your v4 data, you can either use the “import data function” from the menu “Tools -> Import data/settings from another v4 installation” or copy over the data by hand.

Automatic data import

If you decide to use the included data import function, you can directly start it from within the first screen of the wizard or finish the wizard and use the action “Tools -> Import data/settings from another v4 installation” and choose the old v4 installation folder (macOS users: you just need to point to the This function will copy over all your old data into the new location and restart itself.

If you have a large library, you should adopt the memory settings to a higher value before importing your old data.

Manual data import

If you decide to migrate the data from your v4 installation by hand, you just need to

  1. Install and start tinyMediaManager v5 and complete the wizard. If you need a custom memory setting, change it now.
  2. Copy the folders data and cache from your v4 installation over to the v5 installation (you find the v5 folders in the beginning of this page. If you use the portable mode, just copy it into the same folder as tinyMediaManager itself). macOS users must right-click on the, choose Show package contents and navigate to Contents->Resources->Java to find those folders.
  3. Start tinyMediaManager v5 and you should have all data and settings from v4.