Install JRiver Media Center and optionally create helper services on several Linux distributions
bryan 38e3cf2548 v0.6 release | 4 yıl önce | |
---|---|---|
.atom-build.yml | 4 yıl önce | |
.gitignore | 4 yıl önce | |
Containerfile | 4 yıl önce | |
README.md | 4 yıl önce | |
installJRMC | 4 yıl önce |
This program will install JRiver Media Center and associated helper services on Fedora (>=29), CentOS (>=8), Ubuntu (>=16.04), and Debian (>=9).
installJRMC
should be executed as your normal user (i.e. don't run it with sudo
). Services are installed for the user that executes the script so do not execute as root unless you want to install system-wide services. Doing so may lead to permissions issues. installJRMC
will prompt you for your sudo
password as necessary to install dependencies and services.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. If any other option is specified then the default install method will need to be specified using --install-repo
(or --install-rpm
). This makes it possible to install services, containers, repos, etc. independent from Media Center.
Here is a list of possible options that can be passed to the script. You can always find the latest supported options by running installJRMC --help
.
--install-repo
Install JRiver Media Center from repository using package manager (Default)
DEB-based OSes: Official package repository
RPM-based OSes: BryanC's unofficial repository
--install-rpm
(RPM-based OSes only) Build RPM from source DEB and install it
--rpmbuild
Build RPM from source DEB
--outputdir PATH
Generate rpmbuild output in this directory (Default: $PWD/outputdir)
--mcversion VERSION
Build or install a specific version (Default: install the latest version)
--restorefile RESTOREFILE
Restore file location for registration (Default: skip registration)
--betapass PASSWORD
Enter beta team password for access to beta builds
--service-user USER
Install systemd services and containers for USER
--service, -s SERVICE
See SERVICES section below for a list of possible services to install
--container, -c CONTAINER
See CONTAINERS section below for a list of possible services to install
TODO: Containers are a work-in-progress
--createrepo
Build rpm, copy to webroot, and run createrepo
--createrepo-webroot PATH
The webroot directory to install the repo (Default: /srv/jriver/)
--createrepo-user USER
The web server user (Default: current user)
--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, cleanup service files, and remove firewall rules (does not remove library files)
When installing systemd services it is important to execute installJRMC
as the user you wish to run the services. Typically this is your normal user account but for some server installations it may be necessary to execute the script as root. If so, use --service-user root
to override sanity checks.
jriver-mediaserver
Enable and start a mediaserver systemd service (requires an existing X server)
jriver-mediacenter
Enable and start a mediacenter systemd service (requires an existing X server)
jriver-x11vnc
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-mediacenter
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
Display to start x11vnc/Xvnc (Default: The current display (x11vnc) or the
current display incremented by 1 (Xvnc))
jriver-createrepo
Install hourly service to build latest MC RPM and run createrepo
It is possible to install multiple services at one time using multiple --service
blocks: installJRMC --install-repo --service jriver-x11vnc --service jriver-mediacenter
jriver-x11vnc
versus jriver-xvnc-mediacenter
jriver-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-mediacenter creates a new Xvnc display and starts a JRiver Media Center service in the foreground of the new VNC display. The requisite firewall rules will also be added to the system firewall to enable remote access.
Note: If jriver-xvnc-mediacenter
finds an existing display it will attempt to increment the display number by 1. This should work fine in most cases, but if you have multiple running X servers on your host machine you should use the --display
option to specify a free display.
installJRMC
will automatically install and enable port forwarding firewall rules to enable remote access to Media Server (52100-52200/tcp, 1900/udp DLNA) and Xvnc/x11vnc (depends on port selection). installJRMC
uses firewall-cmd
on Fedora/CentOS and ufw
on Ubuntu/Debian.
Note: ufw
is not installed by default on Debian but will be installed by installJRMC
. To prevent user lock-out (i.e. SSH), Debian users that have not already enabled ufw
will need to do so (sudo ufw enable
) after running installJRMC
and inspecting their rules.
Coming soon!
installJRMC
Installs the latest version of JRiver Media Center from the repository.
installJRMC --install-repo --service jriver-mediaserver
Installs JRiver Media Center from the repository and starts/enables the /MediaServer service.
installJRMC --install-rpm --restorefile /path/to/license.mjr --mcversion 26.0.56
Builds JRiver Media Center version 26.0.56 RPM from the source DEB, installs it (RPM distros only), and activates it using the specified .mjr license file.
installJRMC --createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user
Builds the RPM, moves it to the webroot, and runs createrepo as www-user
.
installJRMC --service jriver-createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user
Installs 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"
Installs services to share the existing local desktop via VNC and automatically run Media Center on startup.
installJRMC --install-repo --service jriver-xvnc-mediacenter --display ":2"
Installs an Xvnc server on display ':2' that starts Media Center.
installJRMC --uninstall
Uninstalls JRiver Media Center and its associated services and firewall rules. This will not remove your media, media library/database, or automated library backup folder.
Did you find installJRMC
useful? Buy me a coffee!
Did you find a bug? Let me know on Interact!