Skip to content

Commit

Permalink
Upd: remove jekyll specifica
Browse files Browse the repository at this point in the history
  • Loading branch information
jcorporation committed Sep 22, 2024
1 parent e1fc2d4 commit 18f86ba
Show file tree
Hide file tree
Showing 62 changed files with 163 additions and 258 deletions.
3 changes: 1 addition & 2 deletions docs/000-index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /

title: myMPD Documentation
---

Expand Down
4 changes: 2 additions & 2 deletions docs/010-installation/compiling/build-sh.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Compiling with build.sh
---

With the `build.sh` script you can easily build myMPD and create your own packages. Downstream packagers should use [cmake]({{ site.baseurl }}/installation/compiling/cmake) directly.
With the `build.sh` script you can easily build myMPD and create your own packages. Downstream packagers should use [cmake](installation/compiling/cmake) directly.

## Compiling and installing

Expand Down Expand Up @@ -53,7 +53,7 @@ You can self create packages for your distribution:
- `./build.sh pkgrpm` for RPM based distributions (e.g. openSUSE, Fedora)
- `./build.sh pkgdocker` to create a Docker image based on Alpine Linux
- For gentoo you have to create a local overlay: https://wiki.gentoo.org/wiki/Custom_repository, the ebuild file is in the directory `contrib/packaging/gentoo`
- Build a [OpenWrt package]({{ site.baseurl }}/installation/openwrt)
- Build a [OpenWrt package](installation/openwrt)

### Cross compiling debian packages

Expand Down
14 changes: 6 additions & 8 deletions docs/010-installation/compiling/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /installation/compiling/

title: Compiling
---

Expand All @@ -12,7 +11,6 @@ title: Compiling
| [master](https://github.com/jcorporation/myMPD/tree/master) | stable | the latest releas is created from the master branch |
| [devel](https://github.com/jcorporation/myMPD/tree/devel) | unstable | this branch is for the next bugfix release |
| other branches | unstable | development branches for new major and minor releases |
{: .table .table-sm }

Get the appropriated tarball or clone the git repository and checkout the wanted branch.

Expand Down Expand Up @@ -47,8 +45,8 @@ You can type `./build.sh installdeps` as root to install the dependencies (works

## Building myMPD

- [Easy build with the build.sh script]({{ site.baseurl }}/installation/compiling/build-sh)
- [Advanced build with cmake]({{ site.baseurl }}/installation/compiling/cmake)
- [Build it in Termux]({{ site.baseurl }}/installation/compiling/termux)
- [Build it for OpenWrt]({{ site.baseurl }}/installation/compiling/openwrt)
- [Build it for FreeBSD]({{ site.baseurl }}/installation/compiling/freebsd)
- [Easy build with the build.sh script](installation/compiling/build-sh)
- [Advanced build with cmake](installation/compiling/cmake)
- [Build it in Termux](installation/compiling/termux)
- [Build it for OpenWrt](installation/compiling/openwrt)
- [Build it for FreeBSD](installation/compiling/freebsd)
3 changes: 1 addition & 2 deletions docs/010-installation/compiling/openwrt.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /installation/compiling/openwrt

title: OpenWrt
---

Expand Down
3 changes: 1 addition & 2 deletions docs/010-installation/compiling/termux.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /installation/compiling/termux

title: Termux
---

Expand Down
3 changes: 1 addition & 2 deletions docs/010-installation/distributions.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /installation/distributions

title: Distributions
---

Expand Down
7 changes: 3 additions & 4 deletions docs/010-installation/docker.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /installation/docker

title: Docker
---

Expand Down Expand Up @@ -38,7 +37,7 @@ Starts the myMPD docker container:
| `/docker/mympd/cachedir` | myMPD cache directory. Must exist and be writeable by uid 1000. |
| `/var/lib/mpd/music/` | MPD music directory. Use the same path in the container to enable auto detection. |
| `/var/lib/mpd/playlists/` | MPD playlist directory. Use the same path in the container to enable auto detection. |
{: .table .table-sm}


You must create the `cachedir` and `workdir` before starting the container.

Expand Down Expand Up @@ -102,4 +101,4 @@ docker logs -f mympd

You can configure some basic options of myMPD via startup options or environment variables.

- [Configuration]({{ site.baseurl }}/configuration/)
- [Configuration](configuration/)
14 changes: 7 additions & 7 deletions docs/010-installation/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,14 @@ title: Installation

myMPD should run on all current linux distributions. There are four ways to install myMPD:

1. [Distributions with myMPD packages]({{ site.baseurl }}/installation/distributions)
2. [Prebuild Packages]({{ site.baseurl }}/installation/prebuild-packages)
3. [Docker]({{ site.baseurl }}/installation/docker)
4. [Compiling myMPD]({{ site.baseurl }}/installation/compiling/)
1. [Distributions with myMPD packages](installation/distributions)
2. [Prebuild Packages](installation/prebuild-packages)
3. [Docker](installation/docker)
4. [Compiling myMPD](installation/compiling/)

## Supported platforms

- All current linux distributions (x86 and arm)
- [FreeBSD]({{ site.baseurl }}/installation/compiling/freebsd)
- [OpenWrt]({{ site.baseurl }}/installation/compiling/openwrt)
- [Termux]({{ site.baseurl }}/installation/compiling/termux)
- [FreeBSD](installation/compiling/freebsd)
- [OpenWrt](installation/compiling/openwrt)
- [Termux](installation/compiling/termux)
3 changes: 1 addition & 2 deletions docs/010-installation/prebuild-packages-debian.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /installation/prebuild-packages-debian

title: Debian Installation
---

Expand Down
5 changes: 2 additions & 3 deletions docs/010-installation/prebuild-packages.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /installation/prebuild-packages

title: Prebuild packages
---

Expand All @@ -14,7 +13,7 @@ Download the appropriated package for your distribution and install it with the
Following distributions are supported:

- Arch
- [Debian]({{ site.baseurl }}/installation/prebuild-packages-debian)
- [Debian](installation/prebuild-packages-debian)
- Fedora
- Raspian
- openSUSE
Expand Down
5 changes: 2 additions & 3 deletions docs/020-configuration/acl.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /configuration/acl

title: ACL
---

Expand All @@ -21,4 +20,4 @@ ACLs for IPv6 are currently not supported.
| `+0.0.0.0/0`| Allow all |
| `+127.0.0.0/8`| Allow localhost |
| `+127.0.0.0/8,+192.168.0.0/24` | Allow localhost and all hosts in the net 192.168.0.x |
{: .table .table-sm}

5 changes: 2 additions & 3 deletions docs/020-configuration/command-line-options.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /configuration/command-line-options

title: Command line options
---

Expand All @@ -18,4 +17,4 @@ The `workdir` and `cachedir` options are useful if you want to run more then one
| `-w`, `--workdir <path>` | working directory (default: `/var/lib/mympd`). This folder must exist, if not started as root. |
| `-a`, `--cachedir <path>` | cache directory (default: `/var/cache/mympd`). This folder must exist, if not started as root. |
| `-p`, `--pin` | sets a pin for myMPD settings |
{: .table .table-sm }

15 changes: 6 additions & 9 deletions docs/020-configuration/configuration-files.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /configuration/configuration-files

title: Configuration files
---

Expand All @@ -16,7 +15,7 @@ You can use `mympd -c` to create the initial configuration in the `/var/lib/mymp

**Note:**

Use [systemd-run]({{ site.baseurl }}/running#manual-startup), if you use a distribution with systemd, e.g.:
Use [systemd-run](running#manual-startup), if you use a distribution with systemd, e.g.:

```sh
systemd-run -p DynamicUser=yes -p StateDirectory=mympd -p CacheDirectory=mympd -E MYMPD_LOGLEVEL=4 -E MYMPD_HTTP=false -E MYMPD_SSL_PORT=1333 mympd -c
Expand All @@ -26,7 +25,7 @@ systemd-run -p DynamicUser=yes -p StateDirectory=mympd -p CacheDirectory=mympd -

| FILE | TYPE | ENVIRONMENT | DEFAULT | DESCRIPTION |
| ---- | ---- | ----------- | ------- | ----------- |
| acl | string | MYMPD_ACL | | ACL to access the myMPD webserver: [ACL]({{ site.baseurl }}/configuration/acl), allows all hosts in the default configuration |
| acl | string | MYMPD_ACL | | ACL to access the myMPD webserver: [ACL](configuration/acl), allows all hosts in the default configuration |
| album_group_tag | string | MYMPD_ALBUM_GROUP_TAG | Date | Additional tag to group albums |
| album_mode | string | MYMPD_ALBUM_MODE | adv | Set the album mode: `adv` or `simple` |
| cache_cover_keep_days | number | MYMPD_CACHE_COVER_KEEP_DAYS | 31 | How long to keep images in the cover cache; 0 to disable the cache; -1 to disable pruning of the cache. |
Expand All @@ -36,15 +35,14 @@ systemd-run -p DynamicUser=yes -p StateDirectory=mympd -p CacheDirectory=mympd -
| http | boolean | MYMPD_HTTP | true | `true` = Enable listening on http_port |
| http_host | string | MYMPD_HTTP_HOST | `[::]` | IP address to listen on, use `[::]` to listen on IPv6 and IPv4 |
| http_port | number | MYMPD_HTTP_PORT | 80 | Port to listen for plain http requests. Redirects to `ssl_port` if `ssl` is set to `true`. *1 |
| loglevel | number | MYMPD_LOGLEVEL | 5 | [Logging]({{ site.baseurl }}/configuration/logging) - this environment variable is always used |
| loglevel | number | MYMPD_LOGLEVEL | 5 | [Logging](configuration/logging) - this environment variable is always used |
| mympd_uri | string | MYMPD_URI | auto | `auto` or uri to myMPD listening port, e.g. `https://192.168.1.1/mympd` |
| pin_hash | string | N/A | | SHA256 hash of pin, create it with `mympd -p` |
| save_caches | boolean | MYMPD_SAVE_CACHES | true | `true` = saves caches between restart, `false` = create caches on startup |
| scriptacl | string | MYMPD_SCRIPTACL | +127.0.0.1 | ACL to access the myMPD script backend: [ACL]({{ site.baseurl }}/configuration/acl), allows only local connections in the default configuration. The acl above must also grant access. |
| scriptacl | string | MYMPD_SCRIPTACL | +127.0.0.1 | ACL to access the myMPD script backend: [ACL](configuration/acl), allows only local connections in the default configuration. The acl above must also grant access. |
| stickers | boolean | MYMPD_STICKERS | true | Enables the support for MPD stickers. |
| stickers_pad_int | boolean | MYMPD_STICKERS_PAD_INT | false | Enables the padding of integer sticker values (12 digits). |
| webradiodb | boolean | MYMPD_WEBRADIODB | true | Enables the WebradioDB integration. |
{: .table .table-sm }

1. If http_port is disabled: The MPD curl plugin must trust the myMPD CA or certificate checking must be disabled. MPD fetches webradio playlists with http(s) from myMPD webserver.

Expand All @@ -58,6 +56,5 @@ systemd-run -p DynamicUser=yes -p StateDirectory=mympd -p CacheDirectory=mympd -
| custom_cert | boolean | MYMPD_CUSTOM_CERT | false | `true` = use custom ssl key and certificate |
| ssl_cert | string | MYMPD_SSL_CERT | | Path to custom ssl certificate file |
| ssl_key | string | MYMPD_SSL_KEY | | Path to custom ssl key file |
{: .table .table-sm }

- More details on [SSL]({{ site.baseurl }}/configuration/ssl)
- More details on [SSL](configuration/ssl)
17 changes: 8 additions & 9 deletions docs/020-configuration/index.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,22 @@
---
layout: page
permalink: /configuration/

title: Configuration
---

myMPD has no single configuration file. Most of the options are configurable through the web-ui.

There are some command line options to define basic settings, for example the working directory.

- <a href="{{site.baseurl}}/configuration/command-line-options">Command line options</a>
- <a href="command-line-options">Command line options</a>

myMPD populates at first startup the default configuration files. You can configure this files with the `mympd-config` utility.

- <a href="{{site.baseurl}}/configuration/configuration-files">Configuration files</a>
- <a href="{{site.baseurl}}/configuration/mpd-connection">MPD connection</a>
- <a href="configuration-files">Configuration files</a>
- <a href="mpd-connection">MPD connection</a>

Other setting that are not configurable in the web-ui:

- <a href="{{site.baseurl}}/configuration/acl">ACL</a>
- <a href="{{site.baseurl}}/configuration/logging">Logging</a>
- <a href="{{site.baseurl}}/configuration/ssl">SSL</a>
- <a href="{{site.baseurl}}/configuration/pin-protection">Pin protection</a>
- <a href="acl">ACL</a>
- <a href="logging">Logging</a>
- <a href="ssl">SSL</a>
- <a href="pin-protection">Pin protection</a>
5 changes: 2 additions & 3 deletions docs/020-configuration/logging.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /configuration/logging

title: Logging
---

Expand All @@ -18,6 +17,6 @@ The log levels are unix default.
| 5 | notice (default) |
| 6 | info |
| 7 | debug |
{: .table .table-sm}


If you want to start myMPD with a different loglevel as configured you can set the `MYMPD_LOGLEVEL` environment variable accordingly.
7 changes: 3 additions & 4 deletions docs/020-configuration/mpd-connection.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /configuration/mpd-connection

title: MPD connection
---

Expand All @@ -13,7 +12,7 @@ The mpd connection settings can be configured in the web-ui (Main menu -> MPD co
| MPD host | `/run/mpd/socket` |
| MPD port | 6600 |
| MPD timeout | 30 |
{: .table .table-sm}


### MPD autodetection

Expand All @@ -32,6 +31,6 @@ myMPD tries to autodetect the mpd connection only at first start (if no mpd_host
| MPD_HOST | MPD host or path to mpd socket |
| MPD_PORT | MPD port |
| MPD_TIMEOUT | MPD timeout in seconds |
{: .table .table-sm}


This is done after dropping privileges to the mympd user.
5 changes: 2 additions & 3 deletions docs/020-configuration/pin-protection.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /configuration/pin-protection

title: Pin protection
---

Expand All @@ -14,4 +13,4 @@ You can goto the main menu and login to create a session, press `L` or simply ta

The session is valid until restart of myMPD, closing the browser, refreshing the site or you logout.

The <a href="{{site.baseurl}}/references/api/methods">API documentation</a> shows whether a method is protected or not.
The <a href="references/api/methods">API documentation</a> shows whether a method is protected or not.
7 changes: 3 additions & 4 deletions docs/020-configuration/ssl.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /configuration/ssl

title: SSL
---

Expand All @@ -23,7 +22,7 @@ The default certificates are saved in the directory `/var/lib/mympd/ssl/`.
| ca.key | CA private key |
| server.pem | Server certificate |
| server.key | Server private key |
{: .table .table-sm}


The server certificates SAN is:

Expand Down Expand Up @@ -55,4 +54,4 @@ You can of course use your own certificate, e.g. from [Let's Encrypt](https://le
| custom_cert | true |
| ssl_key | path to custom ssl key |
| ssl_cert | path to custom ssl certificate |
{: .table .table-sm}

11 changes: 5 additions & 6 deletions docs/030-running.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /running

title: Running
---

Expand All @@ -26,7 +25,7 @@ The installation process installs a LSB compatible startup script / systemd unit
| open-rc | `/etc/init.d/mympd` |
| systemd | `/usr/lib/systemd/system/mympd` or `/lib/systemd/system/mympd` |
| sysVinit | `/etc/init.d/mympd` |
{: .table .table-sm}


### Systemd usage

Expand Down Expand Up @@ -61,14 +60,14 @@ If you use a distribution with systemd (without a static mympd user):
systemd-run -t -p DynamicUser=yes -p StateDirectory=mympd -p CacheDirectory=mympd /usr/bin/mympd
```

Description of [Commandline-Options]({{ site.baseurl }}/configuration/).
Description of [Commandline-Options](configuration/).

## Docker

Goto [Docker]({{ site.baseurl }}/installation/docker)
Goto [Docker](installation/docker)

## myMPD configuration

You can configure some basic options of myMPD via startup options or environment variables.

- [Configuration]({{ site.baseurl }}/configuration/)
- [Configuration](configuration/)
5 changes: 2 additions & 3 deletions docs/040-debug.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
layout: page
permalink: /debug

title: Debug
---

Expand All @@ -17,7 +16,7 @@ Tips to debug problems with myMPD. Try these steps and reproduce the error.
- Press Ctrl + C to abort
- Reset loglevel: `unset MYMPD_LOGLEVEL`

- **Note:** Use [systemd-run]({{ site.baseurl }}/running#manual-startup), if you use a distribution with systemd
- **Note:** Use [systemd-run](running#manual-startup), if you use a distribution with systemd

### Get logs from running myMPD

Expand Down
Loading

0 comments on commit 18f86ba

Please sign in to comment.