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. It also contains a GPodder integration so you can continue using your current podcast app.

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

# File just needs to be there
touch static/index.html
cargo.exe run --color=always --package podfetch --bin podfetch
cd ui
<npm/yarn/pnpm> install
<npm/yarn/pnpm> run dev

If you want to run other databases you need to install the corresponding diesel cli. For example for postgres you need to install diesel_cli --no-default-features --features postgres and run the same command for running it with cargo.

I 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.

• Easier to setup
• Easier to use

=> No concurrency. So please don't try to download to podcasts at the same time.

version: '3'
services:
  podfetch:
    image: samuel19982/podfetch:latest
    user: ${UID:-1000}:${GID:-1000}
    ports:
      - "80:8000"
    volumes:
      - podfetch-podcasts:/app/podcasts
      - podfetch-db:/app/db
    environment:
      - POLLING_INTERVAL=60
      - SERVER_URL=http://<your-ip>:<your-port>

volumes:
  podfetch-podcasts:
  podfetch-db:

• Better performance
• Better concurrency
• Better stability
• Better scalability

version: '3'
services:
  podfetch:
    image: samuel19982/podfetch:postgres
    user: ${UID:-1000}:${GID:-1000}
    ports:
      - "80:8000"
    volumes:
      - ./podcasts:/app/podcasts
    environment:
      - POLLING_INTERVAL=300
      - SERVER_URL=http://localhost:80 # Adjust to your server url
      - DATABASE_URL=postgresql://postgres:changeme@postgres/podfetch
      - DB_CONNECTIONS=10 # optional
  postgres:
    image: postgres
    environment:
      POSTGRES_USER: ${POSTGRES_USER:-postgres}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-changeme}
      PGDATA: /data/postgres
      POSTGRES_DB: ${POSTGRES_DB:-podfetch}
    volumes:
      - postgres:/data/postgres
    restart: unless-stopped

volumes:
  postgres:

For terraform have a look at the setup directory. There you will find everything needed to start with your infrastructure as code.

Several Auth methods are described here: AUTH.md

Hosting options are described here: HOSTING.md

The CLI usage is described here: CLI.md

You can create an admin, user, or uploader either through CLI or via invites.

To generate an invite, log into Podfetch → Top Right Icon → User Administration → Invites

UI Documentation

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.

• % 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.

Podfetch supports the GPodder API.

The following environment variable must be set to true to enable it:

You will also need to set up BASIC_AUTH or OIDC_AUTH and create a user.

You can use your new user account to log into podcast apps that supports the GPodder API by using your SERVER_URL and login information.

See wiki/GPodder-API for more info.

• 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.
• Basic Auth.
• Import from OPML file.
• Telegram Bot api to get alerted when new episodes are downloaded.
• Like episodes.
• Delete podcasts.