Xefir/nextcloud-app-radio
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
117c170e7c
nextcloud-app-radio/README.md
Jonas Heinrich 117c170e7c add package.json and lock file
2020-10-08 23:13:33 +02:00

3.6 KiB
Raw Blame History

Nextcloud Radio app

This experimental app uses the radio-browser.info api and offers radio stations right in your Nextcloud!

Features

  • Browse hundreds of radio stations world wide and play them directly
  • Save stations to your favorites list
  • Smooth playback with audio transitions
  • Explore new stations in the category section

Maintainers

Installation

  • From the appstore: The most recent and stable version of the app can be found in the official appstore.
  • Using git: In your nextcloud/apps/ directory, run git clone https://git.project-insanity.org/onny/nextcloud-app-radio.git radio. Then go to the Apps manager tab in your Nextcloud web interface, and enable the Radio app.
  • Using the zip archive: Download the latest tar.bz2 archive, extract the directory inside your nextcloud/apps/ directory, and rename it to radio. For stable releases, you can also download one of the releases tar.bz2 archives. Then go to the Apps manager tab in your Nextcloud web interface, and enable the Radio app.
  • Using package manager: For ArchLinux, there is an AUR package available.

Testing

Can be easily tested using Docker:

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

First part of -v is the path to the cloned or downloaded nextcloud radio 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-radio:/opt/nextcloud/apps/radio -d --name nextcloud -p 80:80 rootlogin/nextcloud

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 radio repository.

Adding radio stations

This app uses a public and open database of radio stations as its backend, so any station you add in radio-browser.info (no account required), will be also available in this app. Feel free to contribute :)

Credits

  • radio-browser.info database api as backend for this app
  • Python example code to query stream metadata, took from here.

Donation

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

19mpmuNczGDgdxaBLBn3REEpQLPPcJHZB6