A very simple podcast downloader written in Go

Go to file

Paul Wilde 1fa0b3d2af minor fixes, some broken stuff		2022-03-25 15:00:28 +00:00
main	minor fixes, some broken stuff	2022-03-25 15:00:28 +00:00
structs	removed default toml files and replaced with autocreate files from strings	2021-05-26 13:11:57 +01:00
.gitignore	reorganise so 'go build' works better	2021-05-25 22:22:48 +01:00
go.mod	added taglib library	2021-05-26 11:03:10 +01:00
go.sum	added taglib library	2021-05-26 11:03:10 +01:00
install.sh	added install.sh	2021-05-25 22:30:29 +01:00
LICENSE	added license	2022-03-25 14:47:47 +00:00
main.go	renamed podcatch folder	2022-03-25 14:53:03 +00:00
README.md	renamed podcatch folder	2022-03-25 14:55:58 +00:00

README.md

PodCatch - a simple Podcast downloader

PodCatch is a very simple Podcast downloader written in GoLang built to help me download podcasts and store them in my media directory so Jellyfin can index them and thus can be listened to using Jellyfin's various apps.
Due to how PodCatch is configurable, I'm sure it would have other uses too.

Why PodCatch over other podcast downloaders?

I tried a few other podcast downloaders and largely they were fine, in fact PodCatch definitely borrows some nice ideas from other podcast downloaders. My personal issue with the others is that the filename they download as is not always "friendly"; that is to say, if there's no ID3 data containing the podcast title, trying to organise a list of podcasts with a GUID.mp3 filename in Jellyfin is not easy.
To tackle this issue, PodCatch looks up the title of the Podcast from its RSS feed, strips it of invalid characters, and uses that name as the file name. This allows for a much easier task when organising podcasts.

Install

Very simple install:

chmod +x install.sh
./install.sh
podcatch

Setup

Settings and Podcasts lists are automatically created in the ~/.podcatch/ directory. These files are in the TOML format, and the podcasts.toml file uses a map[string]Podcast interface.
The automatically created files contain some example podcasts from which you should be able to understand the required layout.

Future plans

I'd really like to work on consuming more of the RSS data (i.e. description) and store alongside the MP3 with the hopes that Jellyfin can parse that to supply episode overviews and more data about it.
I have tried working with this a little by creating an NFO file, but this has not worked as yet.