installJRMCThis program will install
JRiver Media Center and associated services on most major Linux distros.
You can always find the latest version of installJRMC, changelog, and documentation in
my repository.
InstructionsDownload and unzip installJRMC from the attachment below or grab the latest stable version directly and execute:
curl -O https://git.bryanroessler.com/bryan/installJRMC/raw/master/installJRMC &&
chmod +x ./installJRMC &&
./installJRMC [--option [ARGUMENT]]
Running `installJRMC` without any options will install the latest version of JRiver Media Center from the official JRiver repository (Ubuntu/Debian) or my
unofficial repository (Fedora/CentOS) using the system package manager (
i.e. --install repo). If any other option is passed, then the install method (--install repo or --install local) must be specified, to make it possible to install services and containers independent of MC.
Options$ installJRMC --help
--install, -i repo|local
repo: Install MC from repository, future updates will be handled by the system package manager
local: Build and install MC package from official source package
--build[=suse|fedora|centos]
Build RPM from source DEB but do not install
Optionally, specify a target distro for cross-building (ex. --build=suse, note the '=')
--compat
Build/install MC without minimum dependency version requirements
--mcversion VERSION
Build or install a specific MC version, ex. "31.0.11"
--arch ARCH
Specify the MC architecture, ex. "amd64", "arm64", etc (default: host architecture)
--outputdir PATH
Generate rpmbuild output in this PATH (default: ./output)
--restorefile RESTOREFILE
Restore file location for automatic license registration
--betapass PASSWORD
Enter beta team password for access to beta builds
--service, -s SERVICE
See SERVICES section below for the list of services to deploy
--service-type user|system
Starts services at boot (system) or user login (user) (default: per-service, see SERVICES)
--container, -c CONTAINER (TODO: Under construction)
See CONTAINERS section below for a list of containers to deploy
--createrepo[=suse|fedora|centos]
Build rpm, copy to webroot, and run createrepo.
Optionally, specify a target distro for non-native repo (ex. --createrepo=fedora, note the '=')
--createrepo-webroot PATH
The webroot directory to install the repo (default: /var/www/jriver/)
--createrepo-user USER
The web server user if different from the current user
--yes, -y, --auto
Always assumes yes for questions
--version, -v
Print this script version and exit
--debug, -d
Print debug output
--help, -h
Print help dialog and exit
--uninstall, -u
Uninstall JRiver MC, service files, and firewall rules (does not remove library or media files)
Servicesjriver-mediaserver (user)
Enable and start a mediaserver systemd service (requires an existing X server)
jriver-mediacenter (user)
Enable and start a mediacenter systemd service (requires an existing X server)
jriver-x11vnc (user)
Enable and start x11vnc for the local desktop (requires an existing X server, does NOT support Wayland)
--vncpass and --display are also valid options (see below)
jriver-xvnc (system)
Enable and start a new Xvnc session running JRiver Media Center
--vncpass PASSWORD
Set vnc password for x11vnc/Xvnc access. If no password is set, the script will either use existing password stored in ~/.vnc/jrmc_passwd or use no password
--display DISPLAY
Manually specify display to use for x11vnc/Xvnc (ex. ':1')
jriver-createrepo (system)
Install hourly service to build latest MC RPM and run createrepo
By default installs as root service to handle www permissions more gracefully
By default, MC services use a sane `--service-type` listed next to the service name in the Services description. User services can be manipulated as an unprivileged user, for example:
systemctl --user stop jriver-mediacenter and begin at user login. System services are manipulable as root, for example:
sudo systemctl stop jriver-servicename@username.service and begin at system boot. Note that it is possible to run all services of a particular user at boot using
sudo loginctl enable-linger username.
Multiple services (but not --service-types) can be installed at one time using multiple --service blocks:
installJRMC --install repo --service jriver-x11vnc --service jriver-mediacenter
jriver-x11vnc versus jriver-xvncjriver-x11vnc shares your existing X display via VNC and can be combined with additional services to start Media Center or Media Server. Conversely,
jriver-xvnc creates a new Xvnc display and starts a JRiver Media Center service in the foreground of the new VNC display.
ContainersComing soon!Firewall`installJRMC` automatically creates port forwarding firewall rules for remote access to Media Network (52100-52200/tcp, 1900/udp DLNA) and Xvnc/x11vnc (if selected), using `firewall-cmd` or `ufw`.
Note: `ufw` is not installed by default on Debian but will be installed by `installJRMC`. To prevent SSH lock-out, Debian users that have not already enabled `ufw` will need to `sudo ufw enable` after running `installJRMC` and inspecting their configuration.
ExamplesinstallJRMC
Install the latest version of MC from the best available repository.
installJRMC --install local --compat
Install a more widely-compatible version of the latest MC version.
installJRMC --install repo --service jriver-mediacenter --service-type user
Install MC from the repository and start/enable jriver-mediacenter.service as a user service.
installJRMC --install local --compat --restorefile /path/to/license.mjr --mcversion 31.0.11
Build and install an MC 31.0.11 comptability RPM locally and activate it using the /path/to/license.mjr
installJRMC --createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user
Build an RPM locally for the current distro, move it to the webroot, and run createrepo as www-user.
installJRMC --service jriver-createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user
Install the jriver-createrepo timer and service to build the RPM, move it to the webroot, and run createrepo as www-user hourly.
installJRMC --install repo --service jriver-x11vnc --service jriver-mediacenter --vncpass "letmein"
Install services to share the existing local desktop via VNC and automatically run MC on startup.
installJRMC --install repo --service jriver-xvnc --display ":2"
Install an Xvnc server on display ':2' that starts MC.
installJRMC --uninstall
Uninstall MC, services, and firewall rules. This will
not remove your media, media library/database, or library backup folder.
Additional InfoDid you find installJRMC useful?
Buy me a coffee!