podfish

module
v0.0.0-...-05a34cb Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 18, 2025 License: GPL-3.0

README

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

demo demo

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 :)

Directories

Path Synopsis
api
shared

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL