https://github.com/j6k4m8/pokkins
Create a podcast from a directory of audio-files, with zero-config.
https://github.com/j6k4m8/pokkins
docker ohp podcast zero-config
Last synced: 3 months ago
JSON representation
Create a podcast from a directory of audio-files, with zero-config.
- Host: GitHub
- URL: https://github.com/j6k4m8/pokkins
- Owner: j6k4m8
- License: apache-2.0
- Created: 2020-01-02T21:05:54.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-11-27T00:52:59.000Z (over 5 years ago)
- Last Synced: 2025-04-07T17:47:01.806Z (about 1 year ago)
- Topics: docker, ohp, podcast, zero-config
- Language: Python
- Size: 20.5 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎧 pokkins
Zero-config podcast hosting.
## use-case
I have a directory full of audio-files on a server, and I want them to be accessible as a podcast.
## usage
Open the directory you want to serve:
```shell
$ cd my-audio
$ ls
Episode1.mp4
Episode2.mp4
```
## docker approach
Start the `pokkins` Docker container:
```shell
$ docker build --rm -t pokkins .
$ docker run -it --rm -v $(pwd):/mnt/vin/eps -p 8092:8092 pokkins
```
If you can guarantee that this host will remain static and publicly accessible, then you can submit `http://[host]:8092/feed.xml` as a podcast URL to most podcast apps.
## native python approach:
Note that you may first need to install dependencies with `poetry install`.
```shell
$ python3 -c "from pokkins import Pokkins; print(Pokkins('eps').generate_rss())" > feed.xml
```
You can now serve the directory over HTTP. One simple way to do this:
```shell
$ python3 -m http.server 8092
```
This hosts the feed XML and the episodes; rather than running a python http server (which is jank!!), you can also upload the whole thing to an s3 bucket, for example.
## faq
#### i came here because i wanted to start a podcast! this looks hard!
mehhh yeah it is, email me at opensource-at-matelsky-dot-com and I'll try to help you
#### how do i add tags? how do I add episode descriptions?
right now, you can't. but if you want those features, â‘ consider using a more advanced podcast syndication service (this one is really just bare-bones to get something running with zero config, and has no bells or whistles) â‘¡ make a new Issue or Pull Request and I'll try to triage!