Podfish

Podfish is a self-hostable podcast client. It lets you browse your favorite podcasts, play episodes, keep track of which episodes you've heard already, and more. It aims to be like Apple Podcasts, Spotify, etc.

Screenshots

How to Run

Getting started is easy. Just run:

cp .env.example .env
docker compose up

Most changes will be automatically reapplied when developing locally, but some changes (ex: installing a node module or changing the UI port) require a rebuild. Containers can be rebuilt like so:

# Rebuilds both containers
docker compose down && docker compose build --no-cache && docker compose up

# Rebuilds the API
docker compose down && docker compose build --no-cache api && docker compose up

# Rebuilds the UI
docker compose down && docker compose build --no-cache ui && docker compose up

Common settings such as the environment (dev/prod), ports, keys, and more can be set in the .env file.

By default the app is accessible at: http://localhost:8080/

The API docs are accessible at: http://localhost:8080/swagger/index.html

Contributing

I'm currently not accepting pull requests as the app is still in its early stages. However I will welcome collaboration once the first major version is released :)