Compare commits

16 Commits

Author SHA1 Message Date
847eb092de Record a podcast needs to stay on the main site 2025-11-26 22:59:48 +01:00
72c3179f1f Fix image location 2025-11-26 22:52:55 +01:00
19f0addc65 Moving the record a podcast page 2025-11-26 22:51:53 +01:00
11730fb7d5 Added some other policies 2025-11-25 21:18:49 +01:00
232ade089e Direct link to policies 2025-09-21 19:22:06 +02:00
200abbd8ee Move Requested topics #13, created new pages 2025-08-29 12:32:31 +02:00
b4a5da7274 Update suggested_changes.md 2025-06-07 07:41:06 +00:00
e3fb66286a Update suggested_changes.md 2025-06-06 19:58:48 +00:00
50e48a8516 Add design_requirements.md 2025-06-06 19:32:25 +00:00
abdb8974fd Added sonos platform 2025-03-08 12:18:44 +01:00
Ken Fallon
501313de54 Update ccdn/README.md 2025-02-17 18:24:59 +00:00
Ken Fallon
66abf13b74 Update ccdn/README.md 2025-02-17 18:23:25 +00:00
Ken Fallon
e39593f8eb Update ccdn/README.md 2025-02-17 18:17:24 +00:00
Ken Fallon
6f5b545c09 Merge pull request '#10 - developer_information.md typographical errors.' (#11) from sgoti/hpr_documentation:future into main
Reviewed-on: HPR/hpr_documentation#11
2025-02-13 11:31:12 +00:00
Sgoti
93bcd4f171 #10 - developer_information.md typographical errors. 2025-02-12 18:17:41 -05:00
Ken Fallon
46bd4158f8 Merge pull request 'Fix issue reference syntax - #9' (#10) from paulj/hpr_documentation:fix-issue-reference into main
Reviewed-on: https://127.0.0.1:3000/HPR/hpr_documentation/pulls/10
Reviewed-by: Ken Fallon <ken_fallon@josh@anhonesthost.com>
2025-02-11 06:44:47 +00:00
7 changed files with 413 additions and 150 deletions

View File

@@ -1,13 +1,12 @@
# Community Content Delivery Network (CCDN)
A location to track the deployment of the HPR Community Content Delivery Network, that provides a mirror network for our content.
_A location to track the deployment of the HPR Community Content Delivery Network, that provides a mirror network for our content._
## Availability of HPR Content
Availability of HPR Content
The HPR site has traditionally been run on a single instance which makes the project vulnerable.
The HPR site has been traditionally been run on a single instance, which makes the project vulnerable.
We have experienced several times where we have suffered from issues resulting from system outages, denial of service attacks, forced decommissioning, or increased costs.
We have experienced several occasions where we have suffered downtime, resulting from system outages, denial of service attacks, forced decommissioning, or increased costs.
There is a clear need to host the content in multiple geographically distributed networks to increase reliability and redundancy.
@@ -15,27 +14,26 @@ Applying a [Content Delivery Network](https://en.wikipedia.org/wiki/Content_deli
These large vendor solutions provide free tiers, but the long term business model shows that these are not sustainable.
Additionally the algorithms used would flag behavior considered normal for HPR contributors, as suspicious and would deny them access.
Additionally the algorithms used would flag behavior, considered normal for HPR contributors, as suspicious and would deny them access.
# Looking to the past
## Looking to the past
At the dawn of the Internet, it was common for websites and services like DNS to be [mirrored](https://en.wikipedia.org/wiki/Mirror_site) by friends.
This was for a long time not a viable option for HPR as the quantity of Audio Content was expensive to host and transfer, and was therefore beyond what a home user could reliably serve.
Over time, in some locations members of our community have access to facilities that a few years ago would have been reserved for Internet Service Providers.
Over time, and in some locations members of our community have access to facilities that a few years ago would have been reserved for Internet Service Providers.
If you are interested in helping hosting the HPR site and media, then please get in touch with _admin @ hackerpublicradio.org_
If you are one of the fortunate people, and would like to contribute hosting of a mirror of the HPR site and media, then please get in touch with _admin @ hackerpublicradio.org_
## Requirements for Hosting
### Requirements for Hosting
- 24/7 Home Service
- fixed IP address
- unlimited bandwidth
- fast > 500mb/sec upload
- large > 1T of storage
- large > 3T of storage
- permission from your ISP to run a web server
- Contact information know to the Janitors
- Optional: [UPS](https://en.wikipedia.org/wiki/Uninterruptible_power_supply)

View File

@@ -36,7 +36,7 @@ That said, we move with the times when there is a clear advantage to do so.
We run up to date patched stable software.
We have a long tradition of supporting and sharing hacker culture. Any identified vulnerability are fixed with credit if requested.
We have a long tradition of supporting and sharing hacker culture. Any identified vulnerabilities are fixed with credit if requested.
We use [RSS](https://www.rssboard.org/rss-specification) as a delivery mechanism, which is by default fault tolerant.
@@ -46,7 +46,7 @@ All our code is on [GitTea](https://repo.anhonesthost.net/HPR), please clone loc
[Our database](https://hackerpublicradio.org/hpr.sql) is updated frequently, please copy locally.
Our media is served from our [Community Content Delivery Network (CCDN)](https://repo.anhonesthost.net/HPR/hpr_documentation/ccdn/)
Our media is served from our [Community Content Delivery Network (CCDN)](https://repo.anhonesthost.net/HPR/hpr_documentation/ccdn/).
Bug reports, and patches are welcome from anyone without commitment.
@@ -61,5 +61,5 @@ In order to contribute you need to [create an account](https://repo.anhonesthost
Once you have set up your account, you will need to set up your local
development environment. [Instructions here](set-up-development-environment.md)
Changes can be submittted as described in [hpr3797 :: How to submit changes to HPR](https://hackerpublicradio.org/eps/hpr3797/index.html).
Changes can be submitted as described in [hpr3797 :: How to submit changes to HPR](https://hackerpublicradio.org/eps/hpr3797/index.html).

View File

@@ -22,9 +22,9 @@ The following are some of the clients, and we request that people help out repor
- [Podchaser](https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/podcatchers/Podchaser)
- [Podtail](https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/podcatchers/Podtail)
- [Radio.net](https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/podcatchers/RadioNet)
- [Sonos](https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/podcatchers/Sonos)
- [Spotify](https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/podcatchers/Spotify)
- [stagefright](https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/podcatchers/stagefright)
- [Top Podcast](https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/podcatchers/TopPodcast)
See Wikipedia for a [list of podcast clients](https://en.wikipedia.org/wiki/List_of_podcast_clients).

View File

@@ -0,0 +1,25 @@
# Sonos
<a href="https://upload.wikimedia.org/wikipedia/commons/a/a8/Sonos_Logo.jpg" >
<img width="200" src="https://upload.wikimedia.org/wikipedia/commons/a/a8/Sonos_Logo.jpg" alt="Sonos logo" />
</a>
<!--
- 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
![Sonos UI](podcatcher_Sonos.png "A screenshot of the Sonos UI")
```
```
## How to install
## Subcribing to HPR
## Playback

102
policies.md Normal file
View File

@@ -0,0 +1,102 @@
# Policies
## Did you notice Harm ?
Therefore if there are any shows that are on the site which you feel [harm HPR](https://lists.hackerpublicradio.com/pipermail/hpr/2022-June/004492.html), first see if a [response episode](https://lists.hackerpublicradio.com/pipermail/hpr/2021-September/004250.html) is sufficient to address the grievance. If not then please bring it to the attention of the janitors at hpr, and we will see if the concerns are grounded based on the same criteria as if the show was been posted today.
## We don't tolerate Harassment, Trolling
Hacker Public Radio is dedicated to sharing knowledge in a welcoming community that offers positive feedback and encourages respectful debate.
[Harassment on HPR](https://lists.hackerpublicradio.com/pipermail/hpr/2019-December/003804.html)
## Schedule Guidelines
You must have your show recorded before you reserve a slot.
You must only post a show every two weeks.
[Changes to scheduling guidelines](https://lists.hackerpublicradio.com/pipermail/hpr/2025-September/004922.html)
## Community News
The Community News presenters may exercise discretion in what they read out and refer the audience to the skipped content.
[HPR Community News Comment Summaries](https://lists.hackerpublicradio.com/pipermail/hpr/2025-July/004873.html)
## Auditors
The Auditors role is to observe and report if necessary that the Janitors are been faithful in their communication.
[Auditors on HPR](https://lists.hackerpublicradio.com/pipermail/hpr/2025-September/004908.html)
[Permission to move out a show](https://lists.hackerpublicradio.com/pipermail/hpr/2022-March/004419.html)
## Permission to move out a show
[Permission to move out a show](https://lists.hackerpublicradio.com/pipermail/hpr/2022-March/004410.html)
Janitors can move shows on host permission as normal, but will always ask the mail list where the host cannot or will not move their show.
## HPR is not a podcast platform
[Is HPR a podcast or podcast hosting platform ?](https://lists.hackerpublicradio.com/pipermail/hpr/2022-August/004615.html)
There seems to be a clear desire to keep HPR as a podcast and not transition to a podcast hosting platform. What I came to realize was that the HPR setup could be adapted to become a podcast hosting platform with minor changes. For example, were we to not release the main feed, remove the HPR branding, and provide each show their own schedule, then each hosted podcast (now HPR series) would be their own entity. However it's not something that the community, janitors, or the HPR patrons are enthusiastic about implementing.
## Not everything that "could be of interest to hackers" is allowed.
[Rejecting a show on the grounds that it is "using HPR as a means to push a particular product or view"](https://lists.hackerpublicradio.com/pipermail/hpr/2025-July/004883.html)
## We promote other Creative Commons Works
[Various Creative Commons Works](https://lists.hackerpublicradio.com/pipermail/hpr/2013-April/001216.html)
Allowing people to to submit (a single) interesting/important creative commons works on a given topic to the queue.
Prefixed with a short introduction as to why we should be interested. Submitted, under your own name to the queue.
[Policy Discussion, removal of non free CC-BY-NC license](https://lists.hackerpublicradio.com/pipermail/hpr/2025-March/004853.html)
[Policy Change: Clarification that contributions are CC BY-SA 4.0 unless otherwise stated](https://lists.hackerpublicradio.com/pipermail/hpr/2024-October/004791.html)
## Search Page
[Boo, Hiss, a google search on top of the HPR webpage!](https://lists.hackerpublicradio.com/pipermail/hpr/2013-March/001145.html)
Why we do search like we do.
## Site Security stays with the Site admin
[Implemented a deny list on HPR](https://lists.hackerpublicradio.com/pipermail/hpr/2013-March/001112.html)
Attacks to our site get blocked, no discussion required.
## Avoiding background music
[Bed Music](https://lists.hackerpublicradio.com/pipermail/hpr/2012-November/000877.html)
It can be distracting so avoid if possible.
## Swearing is allowed but remember JWP's Granny is listening.
[Swearing?](https://lists.hackerpublicradio.com/pipermail/hpr/2012-April/000640.html)
Swearing is allowed when necessry but use the explicit tag. And don't go out of your way to be belligerent.
## Dropping the Non Commercial License
[HPR: RFC Changing show to CC-BY-SA](https://lists.hackerpublicradio.com/pipermail/hpr/2011-June/000384.html)
## What is a Syndicated show ?
[Syndicated shows](https://lists.hackerpublicradio.com/pipermail/hpr/2011-January/000214.html)
If a show is posted elsewhere prior to been posted to HPR then it would be considered to be a syndicated show.
## When to wind down HPR
[HPR RIP ?](https://lists.hackerpublicradio.com/pipermail/hpr/2010-September/000109.html)
After a period of intermittent posting, the community decided to continue posting HPR shows.

View File

@@ -0,0 +1,92 @@
# Requested topics
This is a list of topics that have been requested by the community.
## General
- How did you get into podcasting/linux/geekdom?
- What podcasts you listen to and can recommend
- What's in your bag? Tell us what tools/gear/stuff you keep close at hand.
- What got you into Linux?
- Your favorite Android applications.
- Your favorite desktop applications.
- Your favorite browser extensions.
- A introduction to Wireshark.
- How to set up your own blog.
- Choosing a artistic design for website, business cards etc.
- Music Theory
- Installing a VPN to your home network
- Init and System.d
- Episodes for the LPI, or the Networking series.
- Beginning Audio Series for HPR and OSMP Release
- Hackintosh computers - what are they, why would you want one.
- Grub 2.0 introduction and customization.
- FM Transmitter hack to listen into internet streams
- How I Got Into Accessible Computing
- How to do knitting
- How to build a house
- How to solder <a href="<!--% absolute_path(baseurl) %-->eps/hpr1037/index.html">hpr1037</a>,
<a href="<!--% absolute_path(baseurl) %-->eps/hpr1047/index.html">hpr1047</a>
- How to weld
- How to fix a car
- Reviews of stream playing software, (for linuxheads who don't want to keep a browser tab open all the time)
- Reviews of stream ripping software on linux
- Beginners guide to gnuplot
- Nagios series, intro, setup, advanced ...
- How to set up GPG/openPGP
- What I do with my Raspberry Pi
- It broke, I fixed it
- How does coreboot work
- Introduction to HAM Radio
- I've moved and they do it like this here
- How to record a tag team tutorial on a topic
- Open Street Map new editor
- etymology
- functional versus procedural programming
- sed, awk and grep
- Setting up imap/smtp (gmail) in a cli mail program
- Irssi - a sane setup
- Your view of the future
- Alternative uses for Bayesian email classifiers (<a href="https://www.youtube.com/watch?v=JKB5CojW4AA">more info</a>)
- How to use a multimeter, and other basic electronic components like a 555 timer
- How does Hubble remain fixed on a spot in space while in orbit of the earth
- Gnu automake system.
- Any experiences integrating Dell/Wyse thin- and zero- clients into linux networks.
- What Are the Answers I Need, To the Questions I Don't Know Enough to Ask?
## Networking
### IPv6
- What is an IP address, and what is IPv6 - basic settings. Why can't we just NAT at the ISP level, are there privacy issues in having your MAC address as part of your IP?
- How to setup IPv6 on Linux, BSD, Windows, Mac, Spark, Android etc
- IPv6 Addressing terminology , format, shortcuts, address structure, (link local, unique and global), reservations, subnetting, allocation
- IPv6 Firewall, what to block what to allow
- Packet structure
- Troubleshooting IPv6 network issue, using common tools with IPv6, ping icmp, telnet, curl, tcpdump, wireshark,etc
- How discovery is handled, what is used for dhcp
- DNS server setup
- Routing server setup
- Setting up common services like ssh, apache, nginx
- Setting up VPN like wireguard
- Explanation of the new Anycast and why you would use it.
- Transition plans tips and tricks.
## Security
What do we need for a firewall and what are the detection/prevention technologies that we could be implementing?
Beyond Firewall and an IDS/IPS, what do I need?
If you were to treat your home network like a corporate server farm, what tools and hardware would it entail to treat your home network like a security professional?
Should one use a secondary IDS, behind the firewall, to record what the primary defenses missed.
Where and how do I set that up?
Beyond firewall and IDS, what other tools should we be running ?
Where should they be in my network, and how many physical boxes are we talking about ?
Emphasis should be on low power devices and free as in beer tools.
How to Read Logs and Formulate a Response to an Intrusion.
What I've learned from SW, is that you can't prevent an intrusion, it's how to respond when you are compromised.
Again, according to SW, the security manager's job is to detect intrusions, inside 48 hours rather than 48 months.
How can you protect your proprietary data and customer database?
Better uses for IPFS and IPNS to get a better understanding of practical use of this.

46
suggested_changes.md Normal file
View File

@@ -0,0 +1,46 @@
# HPR Suggested Change
## Track reservation key in eps table
Moved from https://repo.anhonesthost.net/HPR/hpr_generator/issues/238
A uploaded show is know by it's key, this should be kept in the eps table so it can be located easily.
## Remove deprecated fields in eps table
Check if version and downloads can be deprecated.
## Comment links should be clickable
Should they ? More moderation needed ?
https://repo.anhonesthost.net/HPR/hpr_generator/issues/157
## Audit of media and supplementary files
https://repo.anhonesthost.net/HPR/hpr_generator/issues/154
Given a show like 2173, which was built to link to supplementary notes on the HPR server, these notes (and other assets) are currently not available because the links are incorrect.
This show references several assets for example:
sqlite> select filename from assets where episode_id = 2173;
┌─────────────────────────────┐
│ filename │
├─────────────────────────────┤
│ hpr2173/blinkt_client.py │
│ hpr2173/blinkt_legends.svg │
│ hpr2173/cronjob_comments │
│ hpr2173/full_shownotes.html │
│ hpr2173/img_01.png │
│ hpr2173/img_02.png │
│ hpr2173/img_03.png │
│ hpr2173/img_04.png │
│ hpr2173/img_05.png │
│ hpr2173/img_06.png │
└─────────────────────────────┘
These are on the IA with the same filenames.
Could this issue be resolved by redirection?