tinyMediaManger is a Java application (which needs at least Java 1.7) which will run on Windows as well as Max OSX and Linux. Because there are little differences between these operating systems, tinyMediaManager’s installation behaviour is a bit different.

On every system tinyMediaManager runs an automated update check at startup. This ensures the installation will stay up to date (with the latest bug fixes and features).


In Windows tinyMediaManager comes in portable format. Inside the (.zip) file there are all the necessairy files from the tinyMediaManager. You should extract all the files from the (.zip) inside a folder, and then either use the tinyMediaManager.exe file, or add a shortcut of it on your desktop.


In Mac OSX the application ships as an .app. All files (program files as well as database/cache and logs) are being hold inside the app.

Simply drag and drop the .app from the zip file to your applications folder and start tinyMediaManager from there.

BE AWARE: you cannot start tinyMediaManager from within the compressed file (.zip)!


In Linux tinyMediaManager comes as a packaged (.zip) file as on Windows Operating System. You should extract all the files from the (.zip) inside a folder, and then either use the tinyMediaManager.sh shell file or you can create a Desktop Shortcut by executing the following script on your terminal inside from your tinyMediaManager’s instance folder.

cat <<EOM >~/.local/share/applications/tinyMediaManager.desktop
[Desktop Entry]

You should download libmediainfo from https://mediaarea.net/en/MediaInfo/Download if that library is outdated in your distributions package archive!

Note: In case you get a blank window when starting tinyMediaManager, see below for a possible solution.


# apt-get install openjdk-8-jdk
# apt-get install libmediainfo
# cd /path/to/tinyMediaManager
# ./tinyMediaManager.sh

Arch Linux

# pacman -S java8-openjdk
# pacman -S libmediainfo
# cd /path/to/tinyMediaManager
# ./tinyMediaManager.sh


# dnf install java-1.8.0-openjdk-devel.x86_64
# dnf install libmediainfo
# cd /path/to/tinyMediaManager
# ./tinyMediaManager.sh

Blank window

Users of non-re-parenting Window Managers (e.g. XMonad) might get a blank window (i.e. a window without anything in it) when starting up tinyMediaManager. This is because the JVM contains a hard-coded list of known non-re-parenting window managers, and certain window managers like XMonad are not included on the list.

Luckily this can be mitigated: install the wmname utility via your package manager, or from https://tools.suckless.org/x/wmname. Then, before you run the command tinyMediaManager.sh, run the command: wmname LG3D. This will instruct the shell to impersonate LG3D, the non-re-parenting window manager written in Java by Sun. Some ugly background info here.

You will have to do this each time before starting up tinyMediaManager, so it’s probably easiest to add this into a shell script. For instance, add the following to a new file tmm.sh inside your tinyMediaManager directory:

wmname LG3D
exec $(dirname)/tinyMediaManager.sh

and run chmod +x tmm.sh once afterwards.

To start tinyMediaManager, run this script (./tmm.sh) instead of tinyMediaManager.sh.

Data/Settings/Cache/Backup locations

tinyMediaManager is designed to encapsulate all generated data as settings, databases, cache, logs and backups into its own folder. But there are some setups which required to have these data in another folder. The following system environment variables help to get these data written to another folders:


set the parent folder of all these data folders. e.g. -Dtmm.contentfolder=/home/user/.tmm


can set all folders differently. e.g. -Dtmm.datafolder=/home/user/.tmm/data, -Dtmm.logfolder=/var/log/tmm.

These parameters can either be set via an file called extra.txt inside the tinyMediaManager folder (statically) or via the starting shellscript (dynamically - with variable expansion like -Dtmm.contentfolder=${HOME}/.tmm).