View source for Amarok/Proposals/GPodderNet

= GPodderNet =
The podcast client application [http://gpodder.org GPodder] has an  [http://gpodder.net open web service] that can be used for podcast discovery as well as subscription and status synchronization.

The API of gpodder.net is available [http://wiki.gpodder.org/wiki/Web_Services/API_2 here] . It's a RESTfull API using OPML and JSON.

gpodder.net can be integrated in Amarok in 2 non-exclusive ways: Internet Service for podcast discovery and a podcast provider to synchronize statuses.

== Internet service ==
The internet service, in it's most basic form will be a podcast directory with search support. However it will also allow the option to log in to gpodder.net to get recommendations and enable the podcast provider.

== Podcast provider ==
gpodder.net works with the concept of devices. Amarok would be a new device entry on the service. Syncing subscriptions is done in the server and has to be configured using the website. Though this mechanism Amarok can be synced with gpodder running on an N900 though the cloud.

Some notes regarding the gpodder.net podcast provider implementation:

* Amarok should check for an already existing Amarok device entry and ask for reuse or create a new one.
* Subscription changes (ex. podcast added, podcast removed) are, after confirmation (in a single checkbox + OK-button dialog), also applied to the local podcasts.

== Status ==
=== History ===
* Since Amarok 2.4.1: Basic Podcast Directory (Top Podcast & Top Tags with Top Podcasts of a Tag)
* Since Amarok 2.5  : Suggestions added in Podcast Directory, first working gpodder.net PodcastProvider (only sending play Actions back to gpodder.net)
=== Future Tasks/Idea ===
* add Search via gpodder.net functionality
* when creating a amarok-hostname device, use new sync api to set up sync with other existing devices
* synchronize every action (download, every pause action) to and from gpodder.net
* Synchronize "New" status
* Convert play actions to amarok bookmarks.