diff --git a/wiki/airsonic-advanced.md b/wiki/airsonic-advanced.md index cac60cd..dafd310 100644 --- a/wiki/airsonic-advanced.md +++ b/wiki/airsonic-advanced.md @@ -1,8 +1,8 @@ # Airsonic-Advanced [Airsonic-Advanced](https://github.com/airsonic-advanced/airsonic-advanced) is -a free and open-source personal media streamer mainly used for -[music and audiobooks](./audio.md). +a free and open-source personal media streamer used for +[music, podcasts and audiobooks](./audio.md). It is a more modern implementation of [Airsonic](./airsonic.md) which in turn is a fork of [Subsonic](./subsonic.md). diff --git a/wiki/airsonic.md b/wiki/airsonic.md index b7c0c7b..ea8d662 100644 --- a/wiki/airsonic.md +++ b/wiki/airsonic.md @@ -1,7 +1,7 @@ # Airsonic [Airsonic](https://github.com/airsonic/airsonic) is a free and open-source -personal media streamer mainly used for [music and audiobooks](./audio.md). +personal media streamer used for [music,podcasts and audiobooks](./audio.md). It is a fork of [Subsonic](./subsonic.md). Airsonic is not maintained anymore and therefore deprecated. A more modern implementation of it is diff --git a/wiki/audio.md b/wiki/audio.md index e97e345..047a6b6 100644 --- a/wiki/audio.md +++ b/wiki/audio.md @@ -1,17 +1,37 @@ # Audio -Music and audiobooks is nice to have on your system. -There are multiple different approaches on how to get it working on your system +Music, audiobooks and podcast are widely enjoyed. +There are multiple different approaches on how to get them onto your system depending on your needs. This entry describes how to handle audio data. +Music and Audiobooks can be obtained by buying the digital files or by +[extracting them off of a CD](#extract-audio-files-from-cds). +Podcasts need a so called Podcatcher. +A Podcatcher is used to subscribe to podcasts and download them automatically. ## Media software -If you want to keep your system clean of much data, you can use this kind of setup. +If you want to keep your system clean of much data, you can use this kind of +setup. There are differences depending on your preffered software interface. -- [Airsonic](./airsonic.md) is a free fork of Subsonic, can be dockerized and has - a web-interface and multiple possible client options. +### Software for Music/Podcasts/Audiobooks + +- [Subsonic](./subsonic.md) is a media streamer for music, podcasts and + audiobooks. + Subsonic is self-hostable. + Subsonic that can be dockerized and has a web-interface aswell as several + clients that can be used. + There are also the free and open-source implementations - that feature all the + same features and using its API - named [Airsonic](./airsonic.md) (no longer + maintained) and its inofficial successor [Airsonic-advanced](./airsonic.md). + +### Software for Podcasts + +- [Podgrab](./podgrab.md) is a free and open-source podcatcher that can also be + used to listen to them. + It is self-hostable and can be dockerized. + It has a web-interface and does not feature client software. ## Audio codecs diff --git a/wiki/docker-images/axhilrex_-_podgrab.md b/wiki/docker-images/axhilrex_-_podgrab.md new file mode 100644 index 0000000..b4cde81 --- /dev/null +++ b/wiki/docker-images/axhilrex_-_podgrab.md @@ -0,0 +1,51 @@ +# axhilrex - podgrab + +This is a docker container for a [Podgrab](../podgrab.md) +server. +The official container and documentation was made by +[axhilrex](https://github.com/akhilrex/podgrab). + +## Set-up + +Create the file `rebuild.sh`. +Change the settings according to your needs and run `./rebuild.sh` afterwards. + +## Environment-variables + +Set the following variables with the -e tag. + +| Name | Usage | Default | +| ---------- | ----------------------------- | ------- | +| `PASSWORD` | Password for `podgrab` user | | + +## Volumes + +Set the following volumes with the -v tag. + +| Outside mount/volume name | Container mount | Description | +| ------------------------- | --------------- | ----------------------- | +| `podgrab_config` | `/config` | Configuration files | +| `media_podcasts` | `/assets` | location for podcasts | + +## Ports + +Set the following ports with the -p tag. + +| Container Port | Recommended outside port | Protocol | Description | +| -------------- | ------------------------ | -------- | ----------- | +| `8080` | `8080` | TCP | WebUI | + +## rebuild.sh + +```sh +#!/bin/sh +docker stop podgrab +docker rm podgrab +docker pull akhilrex/podgrab +docker run --name=podgrab \ + --restart unless-stopped \ + -p 8000:8080 \ + -v "media_podcasts:/assets" \ + -v "podgrab_config:/config" \ + -d akhilrex/podgrab +``` diff --git a/wiki/podgrab.md b/wiki/podgrab.md new file mode 100644 index 0000000..2abff0b --- /dev/null +++ b/wiki/podgrab.md @@ -0,0 +1,9 @@ +# Podgrab + +[Podgrab](https://github.com/akhilrex/podgrab) is free and open-source +podcatcher that can also be used to listen to podcasts. + +## Setup + +The software can be setup via docker with the +[axhilrex](./docker-images/axhilrex_-_podgrab.md). diff --git a/wiki/subsonic.md b/wiki/subsonic.md index 01b31da..9e2b28c 100644 --- a/wiki/subsonic.md +++ b/wiki/subsonic.md @@ -1,7 +1,7 @@ # Subsonic -[Subsonic](https://www.subsonic.org) is a personal media streamer mostly used -for [music and audiobooks](./audio.md). +[Subsonic](https://www.subsonic.org) is a personal media streamer used for +[music, podcasts audiobooks](./audio.md). It is non-free and closed-source. There are free and open-source alternatives named [Airsonic](./airsonic.md) and [Airsonic-Advanced](./airsonic-advanced.md).