Skip to content

Commit

Permalink
Some formulation improvements
Browse files Browse the repository at this point in the history
  • Loading branch information
rstemmer authored Jan 29, 2022
1 parent 1ebe3df commit 5298928
Showing 1 changed file with 14 additions and 10 deletions.
24 changes: 14 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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
Expand All @@ -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)
Expand All @@ -199,7 +202,8 @@ The following list shows on which Linux Distributions I tested the MusicDB back-
* 🔴 [openSUSE Tumbleweed](https://get.opensuse.org/tumbleweed)<sup>1</sup>
* 🟡 [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)<sup>2</sup>
Expand Down

0 comments on commit 5298928

Please sign in to comment.