Standardize repo file

1.35.5 release
Bump final MC34 version
2025-12-14 18:22:19 -05:00 · 2025-11-25 10:44:24 -05:00 · 2025-11-25 10:43:40 -05:00 · 2025-11-22 13:16:37 -05:00 · 2025-11-22 04:06:23 -05:00 · 2025-11-22 04:06:05 -05:00
4 changed files with 2124 additions and 1282 deletions
--- a/.README.bbcode
+++ b/.README.bbcode
@@ -0,0 +1,148 @@
+[size=20pt]installJRMC[/size]
+
+This program installs [url=https://www.jriver.com/]JRiver Media Center[/url] and associated services on most Linux distributions.
+
+You can find the latest version of installJRMC, changelog, and documentation in [url=https://git.bryanroessler.com/bryan/installJRMC]my repository[/url].
+
+[size=18pt]tl;dr (One-line MC install)[/size] 
+[code]curl https://git.bryanroessler.com/bryan/installJRMC/raw/branch/master/installJRMC|bash[/code]
+
+[size=18pt]Instructions[/size]
+
+Download and unzip installJRMC from the attachment below or grab the latest stable version directly:
+[code]curl -O https://git.bryanroessler.com/bryan/installJRMC/raw/branch/master/installJRMC && 
+chmod +x ./installJRMC && 
+./installJRMC [--option [ARGUMENT]]
+[/code]
+
+[tt]installJRMC[/tt] defaults to [tt]--install=repo[/tt] on distros with MC repositories and [tt]--install=local[/tt] on all others.
+Specifying [tt]--build[/tt], [tt]--createrepo[/tt], [tt]--service[/tt], or [tt]--uninstall[/tt] disables the default install method.
+
+[size=18pt]Options[/size]
+
+[code]
+$ 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
+    Specify the MC version, ex. "33", "35.0.24", or "35.0.24-1" (default: latest).
+--arch ARCH
+    Specify the target MC architecture, ex. "amd64", "arm64", etc (default: host architecture).
+--mcrepo REPO
+    Specify the MC repository, ex. "bullseye", "bookworm", "noble", etc (default: host or official).
+--outputdir PATH
+    Generate reusable installJRMC 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.
+--no-update
+    Disable the installJRMC update check.
+--yes, -y, --auto
+    Always assumes yes for questions.
+--version, -v
+    Print installJRMC version and exit.
+--debug, -d
+    Print debug output.
+--help, -h
+    Print help dialog and exit.
+--uninstall, -u
+    Uninstall JRiver MC, service files, firewall rules, etc.
+[/code]
+
+[size=18pt]Services[/size]
+
+[code]jriver-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 else 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.
+[/code]
+
+Services use a sane default [tt]--service-type[/tt] listed next to the service name in the Services description. 
+User services can be manipulated as an unprivileged user, for example: [tt]systemctl --user stop jriver-mediacenter[/tt] and begin at user login.
+System services are manipulable as root, for example: [tt]sudo systemctl stop jriver-servicename@username.service[/tt] and begin at system boot.
+Note that it is possible to run all services of a particular user at boot using [tt][url=https://www.freedesktop.org/software/systemd/man/loginctl.html]sudo loginctl enable-linger username[/url][/tt].
+
+Multiple services (but not [tt]--service-types[/tt]) can be installed at one time using multiple [tt]--service[/tt] blocks:
+[code]installJRMC --install repo --service jriver-x11vnc --service jriver-mediacenter[/code]
+
+[size=14pt][tt]jriver-x11vnc[/tt] versus [tt]jriver-xvnc[/tt][/size]
+
+[url=http://www.karlrunge.com/x11vnc/]jriver-x11vnc[/url] shares your existing X display via VNC and can be combined with additional services to start Media Center or Media Server. Conversely, [url=https://tigervnc.org/doc/Xvnc.html]jriver-xvnc[/url] creates a new Xvnc display and starts a JRiver Media Center service in the foreground of the new VNC display.
+
+[size=18pt]Containers[/size]
+
+[b]Coming soon![/b]
+
+[size=18pt]Firewall[/size]
+
+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 (if available).
+
+[size=18pt]Other Nicities[/size]
+[list]
+[*]Automatically updates [tt]installJRMC[/tt] to the latest release.
+[*]Activates external third-party repositories for improved media playback (hardware decoding, etc.).
+[*]Adds temporary legacy repositories to provide deprecated libraries.
+[*]Links non-standard SSL certs.
+[*]Activates MC if a valid license file is found in common locations.
+[/list]
+
+[size=18pt]Examples[/size]
+[code]installJRMC[/code]
+Install the latest version of MC from the best available repository.
+[code]installJRMC --mcversion 33 --debug[/code]
+Install the latest version of MC33 from the best available repository with debugging output.
+[code]installJRMC --install local --compat[/code]
+Install a more widely-compatible version of the latest MC version.
+[code]installJRMC --install repo --service jriver-mediacenter --service-type user[/code]
+Install MC from the repository and start/enable jriver-mediacenter.service as a user service.
+[code]installJRMC --install local --compat --restorefile /path/to/license.mjr --mcversion 35.0.24[/code]
+Build and install an MC 35.0.24 comptability RPM locally and activate it using the [tt]/path/to/license.mjr[/tt].
+[code]installJRMC --createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user[/code]
+Build an RPM locally for the current distro, move it to the webroot, and run createrepo as www-user.
+[code]installJRMC --service jriver-createrepo --createrepo-webroot /srv/jriver/repo --createrepo-user www-user[/code]
+Install the jriver-createrepo timer and service to build the RPM, move it to the webroot, and run createrepo as www-user hourly.
+[code]installJRMC --install repo --service jriver-x11vnc --service jriver-mediacenter --vncpass "letmein"[/code]
+Install services to share the existing local desktop via VNC and automatically run MC on startup.
+[code]installJRMC --install repo --service jriver-xvnc --display ":2"[/code]
+Install an Xvnc server on display ':2' that starts MC.
+[code]installJRMC --uninstall[/code]
+Uninstall MC, services, and firewall rules. This will [b]not[/b] remove your media, media library/database, or library backups.
+
+[size=18pt]Additional Info[/size]
+
+Did you find installJRMC useful? [url=https://paypal.me/bryanroessler]Paypal me a coffee![/url]
+
+[url=bitcoin:bc1q7wy0kszjavgcrvkxdg7mf3s6rh506rasnhfa4a]↓ ↓ ↓ Bitcoin ↓ ↓ ↓[/url]
+
+[url=bitcoin:bc1q7wy0kszjavgcrvkxdg7mf3s6rh506rasnhfa4a][img]https://repos.bryanroessler.com/files/bc1q7wy0kszjavgcrvkxdg7mf3s6rh506rasnhfa4a.png[/img][/url]
--- a/.gitignore
+++ b/.gitignore
@@ -1,9 +1,7 @@
-**/
-*.zip
-testing.sh
-.lock
-tests
-mwe*
-test*
-container*
-Containerfile
+.old/
+.vscode/
+installJRMC.zip
+README.shdoc.md
+README.bbcode
+output/
+*.code-workspace
--- a/README.md
+++ b/README.md
@@ -1,140 +1,165 @@
 # installJRMC

-This program will install [JRiver Media Center](https://www.jriver.com/) and associated helper services on Fedora, CentOS, Ubuntu, Debian, Linux Mint, and SUSE.
+Installs [JRiver Media Center](https://www.jriver.com/) and associated services on most Linux distributions.

-## README
+You can find the latest version of installJRMC, changelog, and documentation in [my repository](https://git.bryanroessler.com/bryan/installJRMC).

-1. This script will not point major upgrades to your old library. You should **first perform a library backup**, install the new major version, and then restore the library backup in the new version.
-2. Typically `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-level services. Doing so may lead to permissions issues. `installJRMC` will prompt you for your `sudo` password as necessary to install dependencies and services.
-
-## Executing
+## Usage

 `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](https://repos.bryanroessler.com/jriver/) (Fedora/CentOS) using the system package manager. SUSE users will need to use the `--install rpm` install method until a SUSE repo becomes available. If any other option is specified, then the default install method will need to be specified using `--install`. This makes it possible to install services and containers independent of Media Center.
+`installJRMC` defaults to `--install=repo` on distros with Media Center repositories and `--install=local` on others.
+Specifying `--build`, `--createrepo`, `--service`, or `--uninstall` disables the default install method.
+
+### tl;dr
+
+`curl https://git.bryanroessler.com/bryan/installJRMC/raw/branch/master/installJRMC|bash`

 ## Options

-You can always find the latest supported options by running `installJRMC --help`.
-
 ```text
--install, -i repo|rpm
-    repo: Install MC from repository, future updates will be handled by the system package manager
-    rpm: Build and install MC locally (RPM-based OSes only)
--build
-    Build RPM from source DEB (no installation)
--build-suse
-    Override OS detection and build SUSE RPM
+$ 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 locally from official source package.
+--build[=suse|fedora|centos|mandriva]
+    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. "28.0.25"
+    Build or install a specific MC version, ex. "35.0.24" or "33" (default: latest).
+--mcrepo REPO
+    Specify the MC repository, ex. "bullseye", "bookworm", "noble", etc (default: latest official).
+--arch ARCH
+    Specify the MC architecture, ex. "amd64", "arm64", etc (default: host architecture).
 --outputdir PATH
-    Generate rpmbuild output in this PATH (Default: ./output)
+    Generate rpmbuild output in this PATH (default: ./output).
 --restorefile RESTOREFILE
-    Restore file location for automatic license registration (Default: skip registration)
+    Restore file location for automatic license registration.
 --betapass PASSWORD
-    Enter beta team password for access to beta builds
+    Enter beta team password for access to beta builds.
 --service, -s SERVICE
-    See SERVICES section below for the list of services to deploy
--service-user USER
-    Install systemd services and containers for user USER (Default: executing user)
+    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
-    Build rpm, copy to webroot, and run createrepo
--createrepo-suse
-    Override OS detection and run --createrepo with SUSE RPM
--createrepo-webroot PATH
-    The webroot directory to install the repo (Default: /srv/jriver/)
--createrepo-user USER
-    The web server user (Default: current user)
+    See CONTAINERS section below for a list of containers to deploy.
+--createrepo[=suse|fedora|centos|mandriva]
+    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.
+--no-update
+    Disable the installJRMC update check.
+--yes, -y, --auto
+    Always assume yes for questions.
 --version, -v
-    Print this script version and exit
+    Print installJRMC version and exit.
 --debug, -d
-    Print debug output
+    Print debug output.
 --help, -h
-    Print help dialog and exit
+    Print help dialog and exit.
 --uninstall, -u
-    Uninstall JRiver MC, cleanup service files, and remove firewall rules (does not remove library files)
+    Uninstall JRiver MC, service files, and firewall rules (does not remove library or media files).
 ```

-### services
-
-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 safety checks.
+### `--service=`

 ```text
-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
-    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
+jriver-mediaserver [--service-type=user]
+    Enable and start a mediaserver systemd service (requires an existing X server).
+jriver-mediacenter [--service-type=user]
+    Enable and start a mediacenter systemd service (requires an existing X server).
+jriver-x11vnc [--service-type=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 [--service-type=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 [--service-type=system]
+    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 --repo --service jriver-x11vnc --service jriver-mediacenter`
+#### `--service-type=`
+
+Services use a sane default `--service-type` listed next to the service name in the [`--service=`](#--service) section. User services begin at user login and are managed by the unprivileged user, for example: `systemctl --user stop jriver-mediacenter`. System services begin at boot and are managed by root, for example: `sudo systemctl stop jriver-servicename@username.service`. It is possible to run all services of a particular user at boot using [`sudo loginctl enable-linger username`](https://www.freedesktop.org/software/systemd/man/loginctl.html).
+
+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-xvnc`

-[jriver-x11vnc](http://www.karlrunge.com/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](https://tigervnc.org/doc/Xvnc.html) creates a new Xvnc display and starts a JRiver Media Center service in the foreground of the new VNC display.
+[jriver-x11vnc](http://www.karlrunge.com/x11vnc/) shares the existing X display via VNC and can be combined with additional services to start Media Center or Media Server. Conversely, [jriver-xvnc](https://tigervnc.org/doc/Xvnc.html) creates a new Xvnc display and starts a JRiver Media Center service in the foreground of the new VNC display.

-**Note**: If `jriver-xvnc` 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.
-
-### Firewall Rules
-
-`installJRMC` will automatically add port forwarding firewall rules enabling 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/SUSE 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 `sudo ufw enable` after running `installJRMC` and inspecting their configuration.
-
-### containers
+### Containers

 **Coming 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` (if available).
+
+## Other Nicities
+
+* Automatically updates `installJRMC` to the latest release.
+* Activates external third-party repositories for improved media playback (hardware decoding, etc.).
+* Adds temporary legacy repositories to provide deprecated libraries.
+* Links non-standard SSL certs.
+* Activates MC if a valid license file is found in common locations.
+
 ## Examples

 * `installJRMC`

-    Installs the latest version of JRiver Media Center from the repository.
+    Install the latest version of MC from the best available repository.

-* `installJRMC --install repo --service jriver-mediaserver`
+* `installJRMC --mcversion 33 --debug`

-    Installs JRiver Media Center from the repository and starts/enables the /MediaServer service.
+    Install the latest version of MC33 from the best available repository with debugging output.

-* `installJRMC --install rpm --restorefile /path/to/license.mjr --mcversion 28.0.87`
+* `installJRMC --install local --compat`

-    Builds JRiver Media Center version 28.0.87 RPM from the source DEB, installs it (RPM distros only), and activates it using the specified .mjr license file.
+    Install a more widely-compatible version of the latest MC (for older distros).
+
+* `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 35.0.24`
+
+    Build and install an MC 35.0.24 compatibility RPM locally and activate it using the `/path/to/license.mjr`.

 * `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`.
+     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`

-    Installs the jriver-createrepo timer and service to build the RPM, move it to the webroot, and run createrepo as `www-user` hourly.
+    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"`

-    Installs services to share the existing local desktop via VNC and automatically run Media Center on startup.
+    Install services to share the existing local desktop via VNC and automatically run MC on startup.

 * `installJRMC --install repo --service jriver-xvnc --display ":2"`

-    Installs an Xvnc server on display ':2' that starts Media Center.
+    Install an Xvnc server on display ':2' that starts MC.

 * `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.
+    Uninstall MC, services, and firewall rules. This will **not** remove your media, media library/database, or library backup folder.

 ## Additional Info

-Did you find `installJRMC` useful? [Buy me a coffee!](https://paypal.me/bryanroessler?locale.x=en_US)
+Find a bug? [Let me know on Interact!](https://yabb.jriver.com/interact/index.php/topic,141168.0.html)

-Did you find a bug? Let me know on [Interact!](https://yabb.jriver.com/interact/index.php/topic,123648.0.html)
+Find `installJRMC` useful? [Paypal me a coffee!](https://paypal.me/bryanroessler)
+
+[↓ ↓ ↓ Bitcoin ↓ ↓ ↓](bitcoin:bc1q7wy0kszjavgcrvkxdg7mf3s6rh506rasnhfa4a)
+
+[![Bitcoin](https://repos.bryanroessler.com/files/bc1q7wy0kszjavgcrvkxdg7mf3s6rh506rasnhfa4a.png)](bitcoin:bc1q7wy0kszjavgcrvkxdg7mf3s6rh506rasnhfa4a)
--- a/3059
+++ b/3059