A self-hosted podcast manager/downloader/archiver tool to download podcast episodes as soon as they become live with an integrated player.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Go to file
Akhil Gupta e15815d648
Merge pull request #24 from Unending/bubble_color
4 years ago
.github/workflows
client added type to toasted bubble 4 years ago
controllers 1. Download all works instantly 4 years ago
db 1. Download all works instantly 4 years ago
images added more screenshots 4 years ago
model update UI, ability to download/delete all episodes 4 years ago
service numbers wrong if autodownload paused 4 years ago
webassets Merge branch 'master' of https://github.com/akhilrex/podgrab 4 years ago
.env 1. Download all works instantly 4 years ago
.gitignore
Dockerfile
LICENSE
Readme.md added more screenshots 4 years ago
Screenshots.md added more screenshots 4 years ago
docker-compose.yml update docuementation + increase refresh frequency 4 years ago
go.mod added logging 4 years ago
go.sum added logging 4 years ago
main.go 1. Download all works instantly 4 years ago

Readme.md

Contributors Forks Stargazers Issues MIT License LinkedIn


Podgrab

A self-hosted podcast manager to download episodes as soon as they become live
Explore the docs »

Report Bug · Request Feature · Screenshots

Table of Contents

About The Project

Podgrab is a is a self-hosted podcast manager which automatically downloads latest podcast episodes. It is a light-weight application built using GO.

It works best if you already know which podcasts you want to monitor. However there is an experimental podcast search system powered by iTunes built into Podgrab

Motivation

Podgrab started a tool that I initially built to solve a specific problem I had. During the COVID pandemic times I started going for a run. I do not prefer taking by phone along so I would add podcast episodes to my smart watch which could be connected with my bluetooth earphones. Most podcasting apps do not expose the mp3 files directly which is why I decided to build this quick tool for myself. Once it reached a stage where my requirements were fulfilled I decided to make it a little pretty and share it with everyone else.

Product Name Screen Shot More Screenshots

Built With

Installation

The easiest way to run Podgrab is to run it as a docker container.

Using Docker

Simple setup without mounted volumes (for testing and evaluation)

  docker run -d -p 8080:8080 --name=podgrab akhilrex/podgrab

Binding local volumes to the container

   docker run -d -p 8080:8080 --name=podgrab -v "/host/path/to/assets:/assets" -v "/host/path/to/config:/config"  akhilrex/podgrab

Using Docker-Compose

Modify the docker compose file provided here to update the volume and port binding and run the following command

version: "2.1"
services:
  podgrab:
    image: akhilrex/podgrab
    container_name: podgrab
    environment:
      - CHECK_FREQUENCY=240
    volumes:
      - /path/to/config:/config
      - /path/to/data:/assets
    ports:
      - 8080:8080
    restart: unless-stopped
   docker-compose up -d

Environment Variables

Name Description Default
CHECK_FREQUENCY How frequently to check for new episodes and missing files (in minutes) 30

License

Distributed under the MIT License. See LICENSE for more information.

Roadmap

Following are the things that I plan to complete in the near future.

  • Some more code refactoring.
  • API standardisation so that it can be used to build apps on top of it.
  • Better search and discovery

Contact

Akhil Gupta - @akhilrex

Project Link: https://github.com/akhilrex/podgrab

Buy Me A Coffee