nextcloud app that replicates basic gpodder.net api
Go to file
Vieno Hakkerinen f7ba81316d allign codecheck with currently maintained versions
* remove stable25 as it is end of life
* add stable28 as nextcloud server is currently at 28.0.0 RC1
2023-12-02 10:54:48 +01:00
.github allign codecheck with currently maintained versions 2023-12-02 10:54:48 +01:00
appinfo Release 3.8.1 - support for NC 27 2023-06-18 22:36:19 +02:00
lib this exception will not be thrown anymore 2023-02-24 20:54:19 +01:00
src Apply suggestions from code review 2022-10-28 09:50:44 +02:00
templates/settings Removed old code 2022-10-28 09:50:44 +02:00
tests delete conflicting episode action if current episode actions updates to same episode url 2023-02-24 20:48:53 +01:00
vendor Ran composer update 2022-10-28 09:50:44 +02:00
.eslintrc.js Initial test version 2022-10-28 09:50:44 +02:00
.gitignore Ignore phpunit cache 2022-10-28 09:50:44 +02:00
babel.config.js Initial test version 2022-10-28 09:50:44 +02:00
CHANGELOG.md Release 3.8.1 - support for NC 27 2023-06-18 22:36:19 +02:00
composer.json require >= php8.0 2023-03-23 11:12:51 +01:00
composer.lock Bump phpunit/phpunit from 9.6.13 to 9.6.14 2023-12-02 10:53:06 +01:00
jsconfig.json Smallfix for TS intellisense 2022-10-28 09:50:44 +02:00
LICENSE Add AGPL 3.0 LICENSE 2022-07-20 20:13:05 +02:00
Makefile ignore releases directory from tarball 2021-08-14 20:15:31 +02:00
package-lock.json Updated npm packages 2022-10-28 09:50:44 +02:00
package.json Updated npm packages 2022-10-28 09:50:44 +02:00
README.md Deprecate Garmin app in README, as it's archived 2023-11-14 23:16:40 +01:00
stylelint.config.js Initial test version 2022-10-28 09:50:44 +02:00
webpack.config.js Initial test version 2022-10-28 09:50:44 +02:00

nextcloud-gpodder

Nextcloud app that replicates basic gpodder.net api to sync podcast consumer apps (podcatchers) like AntennaPod.

Clients supporting sync

client support status
AntennaPod Initial purpose for this project, as a synchronization endpoint for this client.
Support is available as of version 2.5.1.
KDE Kasts Supported since version 21.12
Podcast Merlin Full sync support podcast client for Windows
Garmin Podcasts Repository archived, app is no longer available

Installation

Either from the official Nextcloud app store (link to app page) or by downloading the latest release and extracting it into your Nextcloud apps/ directory.

API

subscription

  • get subscription changes: GET /index.php/apps/gpoddersync/subscriptions
    • (optional) GET parameter since (UNIX time)
  • upload subscription changes : POST /index.php/apps/gpoddersync/subscription_change/create
    • returns JSON with current timestamp

The API replicates this: https://gpoddernet.readthedocs.io/en/latest/api/reference/subscriptions.html

Example requests:

GET /index.php/apps/gpoddersync/subscriptions?since=1633240761

{
  "add": [
    "https://example.com/feed.xml",
    "https://example.org/feed/"
  ],
  "remove": [
    "https://example.net/feed.rss"
  ],
  "timestamp": 1663540502
}
POST /index.php/apps/gpoddersync/subscription_change/create

{
  "add": [
    "https://example.com/feed.xml",
    "https://example.org/feed/"
  ],
  "remove": [
    "https://example.net/feed.rss"
  ]
}

episode action

  • get episode actions: GET /index.php/apps/gpoddersync/episode_action
    • (optional) GET parameter since (UNIX time)
    • fields: podcast, episode, guid, action, timestamp, position, started, total
  • create episode actions: POST /index.php/apps/gpoddersync/episode_action/create
    • fields: podcast, episode, guid, action, timestamp, position, started, total
    • position, started and total are optional, default value is -1
    • guid is also optional, but should be sent if available
    • identification is done by guid, or episode if guid is missing
    • returns JSON with current timestamp

The API replicates this: https://gpoddernet.readthedocs.io/en/latest/api/reference/events.html

Example requests:

GET /index.php/apps/gpoddersync/episode_action?since=1633240761

{
    "actions": [
      {
       "podcast": "http://example.com/feed.rss",
       "episode": "http://example.com/files/s01e20.mp3",
       "guid": "s01e20-example-org",
       "action": "PLAY",
       "timestamp": "2009-12-12T09:00:00",
       "started": 15,
       "position": 120,
       "total":  500
      },
      {
       "podcast": "http://example.com/feed.rss",
       "episode": "http://example.com/files/s01e20.mp3",
       "guid": "s01e20-example-org",
       "action": "DOWNLOAD",
       "timestamp": "2009-12-12T09:00:00",
       "started": -1,
       "position": -1,
       "total":  -1
      },
    ],
    "timestamp": 12345
}
POST /index.php/apps/gpoddersync/episode_action/create

[
  {
   "podcast": "http://example.com/feed.rss",
   "episode": "http://example.com/files/s01e20.mp3",
   "guid": "s01e20-example-org",
   "action": "play",
   "timestamp": "2009-12-12T09:00:00",
   "started": 15,
   "position": 120,
   "total":  500
  },
  {
   "podcast": "http://example.org/podcast.php",
   "episode": "http://ftp.example.org/foo.ogg",
   "guid": "foo-bar-123",
   "action": "DOWNLOAD",
   "timestamp": "2009-12-12T09:05:21",
  }
]

Development

Testing

  • mount project into apps-extra of nextcloud environment (https://github.com/juliushaertl/nextcloud-docker-dev)
  • docker-compose exec nextcloud occ app:enable gpoddersync enable app so we have database tables
  • docker-compose exec nextcloud phpunit9 -c apps-extra/nextcloud-gpodder/tests/phpunit.xml