gpodder2go is a simple self-hosted, golang, drop-in replacement for gpodder/mygpo server to handle podcast subscriptions management for gpodder clients.
To build an easily deployable and private self-hosted drop-in replacement for gpodder.net to facilitate private and small group sychronization of podcast subscriptions with fediverse support
- To support the authentication and storing/syncing of subscriptions and episode actions on multi-devices accounts
- Target to fully support the following gpodder APIs
- Authentication API
- Subscriptions API
- Episode Actions API
- Device API
- Device Synchronization API
- Target to fully support the following gpodder APIs
- To provide a pluggable interface to allow developers to pick and choose the data stores that they would like to use (file/in-memory/rdbms)
To join gpodder2go with the fediverse to allow for independent gpodder2go servers to communicate with one another to discover and share like-minded podcasts that the communities are listening to
gpodder2go will not come with it a web frontend and will solely be an API server. While this is not totally fixed and may change in the future, the current plan is to not handle anything frontend.
gpodder2go requires a database to manage the subscription and user states. Currently the project only supports SQLite with plans to support other databases. The current database mechanism is managed by a DataInterface which allows for quick easy support of new database stores when needed.
- Pull the entire source code
- Download the respective binary and put it in the project repository root
- Initialize the necessary database and configurations
$ ./gpodder2go init
- Start the gpodder server
$ VERIFIER_SECRET_KEY="" gpodder2go serve
Note: VERIFIER_SECRET_KEY is a required env var. This value will be used to sign and verify the sessionid which will be used to authenticate users.
- Create a new user
$ gpodder2go accounts create <username> --email="<email>" --name="<display_name>" --password="<password>"
Note: Each of the commands have a bunch of flags that you can use, to view the full list of available flags, use --help or -h after the commands.
Right now it appears that the gpodder client doesn't fully support auth (see: gpodder/gpodder#617 and gpodder/gpodder#1358) even though the specification (https://gpoddernet.readthedocs.io/en/latest/api/reference/auth.html) explicitly defines it.
In order to allow gpodder client access to the gpodder server, please run gpodder2go in non-auth mode.
$ gpodder2go server --no-auth
Note: This will allow anyone with access to retrieve your susbcriptions data and list. Please take the necessary steps to secure your instance and data.
Alternatively, you can switch to use Antennapod which has implemented the login spec which gpodder2go currently supports.
$ go run main.go
Available with a custom overlay at: https://github.com/seigakaku/gentoo_ebuilds/tree/master/media-sound/gpodder2go
Add with:
# eselect repository add seiga git https://github.com/seigakaku/gentoo_ebuilds