Podfetch is a self-hosted podcast manager. It is a web app that lets you download podcasts and listen to them online. It is written in Rust and uses React for the frontend.
Every time a new commit is pushed to the main branch, a new docker image is built and pushed to docker hub. So it is best to use something like watchtower to automatically update the docker image.
- Rust
- Cargo
- Node
- npm/yarn/pnpm
cargo.exe run --color=always --package podgrabv2 --bin podgrabv2
cd ui
<npm/yarn/pnpm> install
<npm/yarn/pnpm> run devI would love to have a UX expert to help me with the UI. If you are interested in helping me out, please contact me via GitHub issue with designs/implemented React pages.
version: '3'
services:
podfetch:
image: samuel19982/podgrabv2:latest
ports:
- "80:8000"
volumes:
- podgrab-podcasts:/app/podcasts
- podgrab-db:/app/db/podcast.db
environment:
- POLLING_INTERVAL=60
- SERVER_URL=http://<your-ip>:<your-port>
volumes:
podgrab-podcasts:
podgrab-db:| Variable | Description | Default |
|---|---|---|
| POLLING_INTERVAL | Interval in minutes to check for new episodes | 60 |
| SERVER_URL | URL of the server | http://localhost:8000 |
| DATABASE_URL | URL of the database | sqlite://./db/podcast.db |
The podcast listening tool contains an advanced audio player that can be used to listen to your podcasts,skip episodes, turn the volumes as high as 300% or skip around in the current episode.
The tool will automatically save your progress in the current episode and will resume from where you left off even if you close the browser. You can continue listening on all devices by just hitting play on any episode on your home screen.
You can search for podcast episodes by hitting CTRL+F and typing any word that might appear in the description or title of the podcast episode you want to listen to.
Podfetch is currently available in English and German. If you want to add a new language you can do so by adding a new file to the i18n folder and adding the translations to the file.
Podfetch offers an own feed to download podcast episodes. You can add the url <SERVER_URL>/rss to your favorite podcast app like gPodder to download and play episodes.
It is also possible to retrieve/add podcasts from Podcast Index. To configure it you need to create an account on that website. After creating an account an email is sent to you with the required credentials.
| Variable | Description | Default |
|---|---|---|
| PODINDEX_API_KEY | the API key sent to you via mail | % |
| PODINDEX_API_SECRET | the API secret also found in the mail | % |
- % means an empty string is configured as default
After successful setup you should see on the settings page a green checkmark next to the Podindex config section.
- Add podcasts via Itunes API
- Check for new episodes.
- Download episodes.
- Play episodes.
- Force refresh download of podcast episodes.
- Force refresh of podcast episodes.
- Resume podcasts even if browser is closed.
- Add websocket support for new podcasts.
- Add detailed audio player.
- Star podcasts.
- Unsubscribe podcasts.
- Add retrieving podcasts from Podcastindex.org.
- Like episodes.
- Delete podcasts.