Add setting up local dev env docs (#537)
authorMarvin Schenkel <marvinschenkel@gmail.com>
Thu, 16 Mar 2023 14:43:56 +0000 (15:43 +0100)
committerGitHub <noreply@github.com>
Thu, 16 Mar 2023 14:43:56 +0000 (15:43 +0100)
This PR adds
* A template / structure for dev docs.
* Content of setting up a local dev env.

DEVELOPMENT.md [new file with mode: 0644]

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
new file mode 100644 (file)
index 0000000..fb4f566
--- /dev/null
@@ -0,0 +1,29 @@
+Developer docs
+==================================
+
+## 📝 Prerequisites
+* ffmpeg (minimum version 4, version 5 recommended), must be available in the path so install at OS level
+* Python 3.11 is minimal required (or check the pyproject for current required version)
+* [Python venv](https://docs.python.org/3/library/venv.html)
+
+It is recommended to use Visual Studio Code as your IDE, since launch files to start Music Assistant are provided as part of the repository. Furthermore, the current code base is not verified to work on a native Windows machine. If you would like to develop on a Windows machine, install [WSL2](https://code.visualstudio.com/blogs/2019/09/03/wsl2) to increase your swag-level 🤘.
+
+## 🚀 Setting up your development environment
+With this repository cloned locally, execute the following commands in a terminal from the root of your repository:
+* `python -m venv .venv` (create a new separate virtual environment to nicely separate the project dependencies)
+* `source .venv/bin/activate` (activate the virtual environment)
+* `pip install -r requirements_all.txt` (install the project's dependencies)
+* Hit (Fn +) F5 to start Music Assistant locally
+* The pre-compiled UI of Music Assistant will be available at `localhost:8095` 🎉
+
+## 🎵 Building your own Music Provider
+Will follow soon™
+
+## ▶️ Building your own Player Provider
+Will follow soon™
+
+## 💽 Building your own Metadata Provider
+Will follow soon™
+
+## 🔌 Building your own Plugin Provider
+Will follow soon™