From 52989282f2a075bfb3f2b954e10c656637c83eb6 Mon Sep 17 00:00:00 2001 From: Ralf Stemmer Date: Sat, 29 Jan 2022 23:47:03 +0100 Subject: [PATCH] Some formulation improvements --- README.md | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 4074fb8e..63572046 100644 --- a/README.md +++ b/README.md @@ -44,9 +44,8 @@ [⚙️ Install, Setup and Run MusicDB with Apache and Icecast](https://rstemmer.github.io/musicdb/build/html/usage/install.html) -MusicDB requires Python 3 version 3.9.0 or later. - -MusicDB is hardware independent. It works with any Linux distribution installed on PC, ARM (like [Raspberry Pi](https://www.raspberrypi.com/)) or Mac. +MusicDB requires Python 3.9 or later. +The WebUI requires an up-to-date Firefox. **Important:** See [Transition from 7.2.0 to 8.0.0](https://rstemmer.github.io/musicdb/build/html/basics/data.html#transition-from-7-2-0-to-8-0-0) in case you already have MusicDB 7.2.0 installed. @@ -169,6 +168,8 @@ In case MusicDB does not run on outdated operating systems, update your system : * [Apache](https://httpd.apache.org/) for serving the Web User Interface * A detailed list of all dependencies can be found in the [Install from Source](https://rstemmer.github.io/musicdb/build/html/usage/fromsource.html) documentation +MusicDB is hardware independent. It works with any Linux distribution installed on PC, ARM (like [Raspberry Pi](https://www.raspberrypi.com/)) or Mac. + I develop and operate MusicDB on an [Arch Linux](https://www.archlinux.org/) for x86-64. So on this system it will run most reliable :smiley:. ### Note on Debian/Ubuntu @@ -178,19 +179,21 @@ I do not support Debian/Ubuntu distributions for lots of reasons. Anyway, periodically I test MusicDB also on an [Raspberry Pi 4](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/) with [Ubuntu](https://ubuntu.com/download/raspberry-pi) or [Raspberry PI OS](https://www.raspberrypi.com/software/) which is Debian based. +So, in principle it works. +There may be a .deb package for the latest Ubuntu system, but again, expect some difficulties using MusicDB on Debian/Ubuntu. +Some quirks with Debian/Ubuntu are documented in the installation documentation. -Sometime it happens that MusicDB does not run on Debian/Ubuntu because some packages provided by those distributions are too old. +Sometime it happens that MusicDB does not run on certain distributions like Debian or Ubuntu LTS because the packages provided by those distributions are too old. I consider this as an issue of those distributions, not of MusicDB. -There may be a .deb package for the latest Ubuntu system, but again, expect some difficulties using MusicDB on Debian/Ubuntu. - -I recommend Arch Linux or Fedora to run MusicDB on. +For best experience I recommend Arch Linux or Fedora to run MusicDB. -### Tests +### Tested Distributions and Browsers 🟢 Test succeeded, 🔴 Test failed, 🟡 Not tested -The following list shows on which Linux Distributions I tested the MusicDB back-end and if it succeeded. + +The following list shows on which Linux distribution installing and running the MusicDB back-end succeeded: * 🟢 [Arch Linux](https://archlinux.org/) * 🟢 [Fedora 35](https://getfedora.org) @@ -199,7 +202,8 @@ The following list shows on which Linux Distributions I tested the MusicDB back- * 🔴 [openSUSE Tumbleweed](https://get.opensuse.org/tumbleweed)1 * 🟡 [Raspberry PI OS](https://www.raspberrypi.com/software/) -The following list shows with which web browsers I tested the MusicDB front-end and if it succeeded. + +The following list shows on which web browser running the MusicDB front-end succeeded: * 🟢 [Firefox](https://www.mozilla.org/en-US/) * 🔴 [Chrome](https://www.google.com/chrome/index.html)2