Nextcloud Podcast app

Browse, listen and subscribe to podcasts inside of Nextcloud. The podcast app uses the directory fyyd.de as a source.

Features

• Browse podcasts and play them directly in Nextcloud
• Keep track of subscribed shows and episodes
• Check newly released episodes
• Support for chapters in episodes
• Support for links and timecodes in episode notes
• Import and export subscriptions
• Mobile friendly interface
• Unified search integration
• Dashboard integration

Maintainers

• Jonas Heinrich

Installation

From the appstore

The most recent and stable version of the app can be found in the official appstore. For ArchLinux, there is an AUR package available.

From source

Clone the development repository with:

git clone https://git.project-insanity.org/onny/nextcloud-app-podcast.git podcast

Then run following commands to compile the project:

cd podcast
make dev-setup
make build-js

Mount or move the podcast folder into your Nextcloud apps/ directory. Go to the apps manager tab in your Nextcloud web interface, and enable the Podcast app.

Adding podcast shows

This app uses a public and open database of podcasts as its backend called fyyd. If you want a specific podcast listed in the app, you have to submit it first there.

Testing

Can be easily tested using Docker:

docker build https://git.project-insanity.org/onny/docker-nextcloud.git nextcloud
docker run -v /tmp/nextcloud-app-podcast:/opt/nextcloud/apps/podcast -d --name nextcloud-app-podcast -p 80:80 nextcloud

First part of -v is the path to the cloned and compiled or downloaded Nextcloud Podcast app. Debug running container it with:

docker exec -i -t 665b4a1e17b6 /bin/bash

Where -t specifies the container id. If you further need to access the sqlite-database, logs or files inside the data folder of Nextcloud, that you also have to share this folder with the host:

docker run -v /tmp/dockerdata:/data/data -v /tmp/nextcloud-app-podcast:/opt/nextcloud/apps/podcast -d --name nextcloud -p 80:80 rootlogin/nextcloud

To manually test unstable Nextcloud or PHP versions, you can do this:

git clone https://git.project-insanity.org/onny/docker-nextcloud.git
docker build -t nextcloud-21 .
docker run -v /tmp/nextcloud-app-podcast:/opt/nextcloud/apps/podcast -d --name nextcloud-app-podcast-21 -p 80:80 nextcloud-21

Development notes

General

While editing the code, you could run following helper script to automatically compile the project:

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p # ref: https://github.com/gatsbyjs/gatsby/issues/11406
make watch-js

Seeing PHP and server error logs is possible with following command:

docker logs <CONTAINERID>

Translations

Manually generate translations. The following commands will require the dependency packages gettext and php.

cd nextcloud-app-podcast
git clone https://github.com/nextcloud/docker-ci.git utils/docker-ci
make translations

Use the source file translationfiles/template/podcast.pot to create translations. For example, contribute translations via Transifex.

Put the translated language file into the corresponding template folder. For example the German language file should be placed at translationfiles/de/podcast.po. Run make translations again.

Prepare a release

Consoult Release.md on how to prepare a release for Gitlab and the app store.

Contribute

Reporting bugs

You can report bugs in the public gitlab repository here and for discussion you can find a section for the app in the offical Nextcloud forums here.

Adding translations

For now only German translations are provided, so please submit your translations if possible :) It's really easy, just git clone this repo and copy the translation files in l10n according to your locale. Merge requests go to this podcast repository.

Donation

If you like this app and want to support my work, you can donate to this MobileCoin address:

v2Z6pvq2zWLmQeP1ywxe9G4k3wQqbxrNvLk8zF1XVJjkvyd3dVjJmyHysyG1hHehiPPyKFkgoPHHBRGnDp4CzpJUxd2g5vWcTvfHukMy7iQaVEgkeErWkQnzey3ArnAPMhMB6DJYkqYQ2DjYNAwqFBvrS3rjiBEgo9aM6LEUuJmeckai9UTaKA9g9sH8k5TwKUMmmLx35Y3gn8zGMVsWxc8e2UuLRho9Gwvs4eiMmV634QkKLASxtYq24SbzxPdc9p

Credits

• fyyd.de database api as backend for this app
• App logo is taken from svgrepo.com and licensed under MIT