From JRiverWiki
Revision as of 06:57, 21 April 2014 by Inflatablemouse (talk | contribs) (System requirements)

Jump to: navigation, search

This document will guide you through the process of installing and configuring MediaCenter for Linux. You are advised to read through the document before installing MediaCenter. It assumes some basic knowledge of Linux in general and familiarity working from a terminal. It also assumes an installation on 64-bit distribution as that will most likely be the target system. Installation on a 32-bit system will be very similar and, where applicable, notes will clarify the differences.

Throughout this document you are required to run certain commands in a terminal, sometimes with root permissions. Whether you do that as root itself or using temporarily elevated permissions through sudo is up to you. This document will precede each command with a # or $ sign, signifying whether the command needs to run as root (#) or as a regular user ($). Unless you changed your terminal prompt, it will show this same symbol for root (#) or user ($) on its prompt. You should not include this symbol in your command, it only signifies how the command should be run.

Outdated: This content is outdated currently, and may no longer be fully accurate. You can help the JRiver Wiki by updating it.

Before you begin

MediaCenter is in beta and is under heavy development. As such, it may not work as expected. Although it is considered to be stable enough for regular use it may still show unexpected behavior such as crashes or random refusals to play a track. Please make sure you read through the list of Outstanding issues.

It is strongly advised to make regular backups of your media. There have been no reports of MediaCenter for Linux messing up tags or otherwise corrupting files, but it is still in beta - consider yourself warned. You can configure MediaCenter to not update tags at all, it will only read from your files but that does not negate the fact that you should always have backups.

It is also a good idea to read through the sticky threads on the forums, too.

System requirements

MediaCenter is being developed on Debian Wheezy 32-bit, x86 architecture. It will run on multiarch distributions (64-bit with 32-bit libraries) once the proper 32-bit dependencies are satisfied. See DEPENDENCIES for more information.

MediaCenter requires a CPU that supports SSE2. This means the CPU needs to be from around 2002 or later.

Hardware Requirements (Minimum)

  • Intel or AMD x86 Compatible CPU with SSE2
  • 2GB RAM
  • 300MB free hard drive space for installation (excluding space for digital media)
  • Sound device supported by ALSA
  • Internet connection (recommended)

Software Requirements

  • Debian Wheezy or a similar distribution based on Debian
  • Working Xorg - MediaCenter is known to work on XFCE, Unity and KDE, Gnome and Cinnamon. MATE is currently untested.
  • Working ALSA sound stack

MediaCenter is known to work on recent versions of Mint, Ubuntu, OpenSuse, Fedora and Arch Linux. However, this is considered experimental and it is currently unsupported. If you intent to run MediaCenter on an unsupported distribution, you are strongly encouraged to share your experience on Interact.


Although Linux can run on architectures other than x86 (like ARM or PowerPC for instance), MediaCenter does currently not run on architectures other than i386 or x86_64.

OSS and Pulse are currently not supported by MediaCenter.

MediaCenter can run in server mode on a headless server, but it requires an Xserver running. See HEADLESS for more information.


To successfully install MediaCenter, you need to make sure that the following depencies are installed. Installation on a 64-bit system requires multiarch to be enabled for 32-bit compatibility.

To enable multiarch on a 64-bit system, type the following with root privileges in a terminal:

  1. dpkg --add-architecture i386

This command require you update. As root, type:

  1. apt-get update && apt-get upgrade

If you had not updated in a while, you may get a lot of new packages. Read the output carefully. If it says certain packages are held-back, cancel using CTRL-C and issue the following command as root instead:

  1. apt-get update && apt-get dist-upgrade

You should reboot your system when it is done.

Next we are going to install the following packages and libraries:

lame musepack-tools xfonts-75dpi xfonts-100dpi vorbis-tools

libcurl3:i386 libx11-6:i386 lib32stdc++6 libmpcdec6:i386 libc6:i386 libstdc++6:i386 libx11-6:i386 libcrypto++9:i386 libasound2:i386 libuuid1:i386 libboost-regex1.49.0:i386 libicu48:i386

Note: On a 32-bit system, you can install the same libraries by removing ':i386' part.

Unless you're installing on a fresh install you probably already have some of these installed. This doesn't matter as Aptitude will simply skip packages that are already installed. You can install all of them at once by issuing the following command with root privileges from a terminal:

Downloading MediaCenter

Installing MediaCenter