HPR/hpr_documentation
5
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

Added links for the popular podcatchers

Ken Fallon 2024-11-09 17:08:54 +01:00
parent 6b7863d8c2
commit d704c4b8d7
13 changed files with 332 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
AntennaPod.md Normal file

@ -0,0 +1,20 @@
# AntennaPod
<!--
- Confirmed working with HPR Feeds and [CCDN](https://repo.anhonesthost.net/HPR/hpr_documentation/wiki/Community-Content-Delivery-Network)
- [Source Code on GitHub](https://gpodder.github.io/)
-->
## Description
![AntennaPod UI](AntennaPod.png "A screenshot of the AntennaPod UI")
```
```
## How to install
## Subcribing to HPR
## Playback

61
HPR-Directory-Structure.md

@ -2,13 +2,68 @@
HPR is dedicated to sharing knowledge and as such it should be possible for someone to have the files locally and play them on a mp3 player.
It should be possible to post the entire backlog to someone and have them plug it in and for any media player be able to play it. Each episode should have it's own "album" which corresponds to a directory. The directory structure should be as flat as possible with everything related to show 9876 in a directory `hpr9876` inside of the `eps` directory. This is the least common denominator, and in no way precludes web services, or other applications.
It should be possible to post the entire backlog to someone and have them plug it in and for any media player be able to play it. Each episode has it's own "album" which corresponds to a directory. The directory structure is kept as flat as possible with everything related to show 9876 in a single directory `hpr9876`. This is the least common denominator, and in no way precludes web services, or other applications.
We do however need to support other functionality which also need their own directories but the same logic applies. Hosts are in `hosts/`, and Series are in `series/`. Anything related to either is also in a flat directory.
We do however need to support other functionality so the _Episodes_ are kept inside of the `eps` directory, the _Hosts_ are in `hosts/`, and _Series_ are in `series/`.
# Layers
The source files are delivered by the hosts, some are generated by processing, and others are added by the Janitors that cleanup the shownotes.
We get files from different locations. The source files are delivered by the hosts, some are generated by processing, and others are added by the Janitors that cleanup the show notes.
All these are combined and end up as a complete entity, on one of the HPR [Origin servers](https://en.wikipedia.org/wiki/Upstream_server).
From there is delivered made available via RSS, etc.
## Upload
In our worked example a host uploads a show recorded in an audio file in [flac](https://en.wikipedia.org/wiki/FLAC) format.
The show is about a bash script which they also attach.
They describe the show in show notes, and include an image of the output.
files will be distributed using the C
The show processing supports the building of this structure,
This is how the
The `hpr_generator` places episodes are in `eps/`,
Everything related to a given show should be in the
We need to base our requirements on our own requirements and not those imposed by the IA.
It should be possible for someone to `rsync` the entire site and store it locally for use with a file manager/or media player.
To make file management clear all files must begin with the episode number `hpr9876`.
Supplemental files should be p
If there is a possibility of a clash then we need to ensure that we manage that by avoiding upload names.
should layer ontop of that so `/path/to/disk/hpr/` is the root and then `eps
If any of the sites (The IA) require special treatment, then that's fine but it's a deviation from our structure.
https://archive.org/details/hpr4230 →
The directory structure imposed by IA is less than ideal when it comes to our requirements.

20
Overcast.md Normal file

@ -0,0 +1,20 @@
# Overcast
<!--
- Confirmed working with HPR Feeds and [CCDN](https://repo.anhonesthost.net/HPR/hpr_documentation/wiki/Community-Content-Delivery-Network)
- [Source Code on GitHub](https://gpodder.github.io/)
-->
## Description
![Overcast UI](Overcast.png "A screenshot of the Overcast UI")
```
```
## How to install
## Subcribing to HPR
## Playback

20
PocketCasts.md Normal file

@ -0,0 +1,20 @@
# PocketCasts
<!--
- Confirmed working with HPR Feeds and [CCDN](https://repo.anhonesthost.net/HPR/hpr_documentation/wiki/Community-Content-Delivery-Network)
- [Source Code on GitHub](https://gpodder.github.io/)
-->
## Description
![PocketCasts UI](PocketCasts.png "A screenshot of the PocketCasts UI")
```
```
## How to install
## Subcribing to HPR
## Playback

20
PodcastAddict.md Normal file

@ -0,0 +1,20 @@
# PodcastAddict
<!--
- Confirmed working with HPR Feeds and [CCDN](https://repo.anhonesthost.net/HPR/hpr_documentation/wiki/Community-Content-Delivery-Network)
- [Source Code on GitHub](https://gpodder.github.io/)
-->
## Description
![PodcastAddict UI](PodcastAddict.png "A screenshot of the PodcastAddict UI")
```
```
## How to install
## Subcribing to HPR
## Playback

11
Podcatcher-and-Podcasting-Platform-Compatibility.md

@ -1,11 +0,0 @@
Where we can track Compatibility of the clients subscribed to our feeds.
# gPodder
![gPodder UI](gPodder.png "A screenshot of the gPodder UI")
## Links
- https://gpodder.github.io/

20
Spotify.md Normal file

@ -0,0 +1,20 @@
# Spotify
<!--
- Confirmed working with HPR Feeds and [CCDN](https://repo.anhonesthost.net/HPR/hpr_documentation/wiki/Community-Content-Delivery-Network)
- [Source Code on GitHub](https://gpodder.github.io/)
-->
## Description
![Spotify UI](Spotify.png "A screenshot of the Spotify UI")
```
```
## How to install
## Subcribing to HPR
## Playback

32
bashpodder.md Normal file

@ -0,0 +1,32 @@
# Bashpodder
- Confirmed working with HPR Feeds and [CCDN](https://repo.anhonesthost.net/HPR/hpr_documentation/wiki/Community-Content-Delivery-Network)
- [License](https://github.com/lincgeek/bashpodder/issues/2#issuecomment-364528984): [GPLv3](https://www.gnu.org/licenses/gpl-3.0.en.html)
- [Source Code on GitHub](https://github.com/lincgeek/bashpodder)
## Description
> BashPodder Was written and is maintained here by me (Linc) with the generous code contributions and great ideas of many of its users, some of whom have contributed modified scripts of their own. BashPodder is currently licensed under the GPL. BashPodder was written to be small and fast, and most importantly, to conform to the KISS rule (Keep It Simple Stupid). That way, anyone can add to and detract from the script to suit their own needs (and they are welcome to do so). BashPodder is listed in many places as a "Linux" podcatching client, and in fact, that is what I wrote it for initially, however, it should be noted that I have dozens of emails telling me how well it works on everything else, including but not limited to MaxOSX, Solaris, AIX, Net Open and FreeBSD, even windows and many other OS's I have forgotten I am sure.
> Bashpodder requires you have bash (but I have heard it runs fine under korn as well), wget, sed and xsltproc.
## How to install
1. Clone [bashpodder gothub repo](https://github.com/lincgeek/bashpodder)
1. Confirm that `sed`, `wget`, and `xsltproc` are installed.
## Subscribing to HPR
Pick the [HPR feed](https://hackerpublicradio.org/syndication.html) you want to subscribe to.
Create and edit `podcast.log` and add the feed url on a new line
Allow execution `chmod +x ./bashpodder`
Run the bash script `./bashpodder`
## Playback
The script only downloads files for you and nothing else.
It will create a [ISO8601 YYYY-MM-DD](https://en.wikipedia.org/wiki/ISO_8601) format directory structure.
Other forks exists like [mashpodder](https://github.com/chessgriffin/mashpodder) that allow modification and customization.

45
castget.md Normal file

@ -0,0 +1,45 @@
# castget
- Confirmed working with HPR Feeds and [CCDN](https://repo.anhonesthost.net/HPR/hpr_documentation/wiki/Community-Content-Delivery-Network)
- [Source Code on GitHub](https://castget.johndal.com/)
## Description
```
# dnf info castget
Name : castget
Version : 2.0.1
Release : 9.fc39
Architecture : x86_64
Size : 123 k
Source : castget-2.0.1-9.fc39.src.rpm
Repository : @System
From repo : fedora
Summary : A command-line podcast downloader
URL : https://castget.johndal.com/
License : LGPLv2+
Description : castget is a simple, command-line based RSS enclosure downloader. It is
: primarily intended for automatic, unattended downloading of podcasts.
```
## How to install
The [home page](https://castget.johndal.com/) contains links to download unix like variants.
## Subcribing to HPR
Create and edit `$HOME/.castgetrc`
```
[Hacker_Public_Radio_hpr_rss_php]
spool=/path/to/my/podcasts/Hacker_Public_Radio_hpr_rss_php
url=https://www.hackerpublicradio.com/hpr_rss.php
id3contenttype=Podcast
```
Save the file and run using `castget --resume --verbose --progress-bar`
## Playback
The application only donloads files. You can use whatever player your like to play them.

40
gPodder.md Normal file

@ -0,0 +1,40 @@
# gPodder
- Confirmed working with HPR Feeds and [CCDN](https://repo.anhonesthost.net/HPR/hpr_documentation/wiki/Community-Content-Delivery-Network)
- [Source Code on GitHub](https://gpodder.github.io/)
## Description
![gPodder UI](gPodder.png "A screenshot of the gPodder UI")
```
# dnf info gpodder
Name : gpodder
Version : 3.11.4
Release : 4.fc40
Architecture : noarch
Size : 4.2 M
Source : gpodder-3.11.4-4.fc40.src.rpm
Repository : @System
From repo : fedora
Summary : Podcast receiver/catcher written in Python
URL : http://gpodder.org
License : GPL-2.0-or-later AND GPL-3.0-or-later AND LGPL-2.1-or-later AND LGPL-3.0-or-later AND ISC
Description : gPodder is a Podcast receiver/catcher written in Python, using GTK.
: It manages podcast feeds for you and automatically downloads all
: podcasts from as many feeds as you like.
: It also optionally supports syncing with ipods.
```
## How to install
The [home page](https://gpodder.github.io/) contains links to the Windows, macOS, Linux/BSD, and Others variants.
## Subcribing to HPR
Pick the [HPR feed](https://hackerpublicradio.org/syndication.html) you want to subscribe to.
Hold `Ctrl` and then press `L` to add a feed, or press _Subscribe > Add podcast via URL_.
It will then fetch the feed and allow you to decide which of the episodes to download.
## Playback
Selecting, and Right Clicking an downloaded episode will open an external player, eg [VLC](https://www.videolan.org/vlc/)

20
pocketcasts.md Normal file

@ -0,0 +1,20 @@
# pocketcasts
<!--
- Confirmed working with HPR Feeds and [CCDN](https://repo.anhonesthost.net/HPR/hpr_documentation/wiki/Community-Content-Delivery-Network)
- [Source Code on GitHub](https://gpodder.github.io/)
-->
## Description
![pocketcasts UI](pocketcasts.png "A screenshot of the pocketcasts UI")
```
```
## How to install
## Subcribing to HPR
## Playback

17
show_upload.uml Normal file

@ -0,0 +1,17 @@
@startuml
title Show Upload
participant "Host" as Host
participant "Browser" as Browser
participant "e-mail" as email
participant "HPR" as HPR
autonumber
activate HPR
Host->HPR: http://hackerpublicradio.org/request.php?id={episode_number}
HPR->Host: email Confirm Request with {key}
Host->HPR: http://hackerpublicradio.org/upload.php?key={key}
deactivate HPR
@enduml

20
stagefright.md Normal file

@ -0,0 +1,20 @@
# stagefright
<!--
- Confirmed working with HPR Feeds and [CCDN](https://repo.anhonesthost.net/HPR/hpr_documentation/wiki/Community-Content-Delivery-Network)
- [Source Code on GitHub](https://gpodder.github.io/)
-->
## Description
![stagefright UI](stagefright.png "A screenshot of the stagefright UI")
```
```
## How to install
## Subcribing to HPR
## Playback