Backend Service which can be used for creation a custom podcasts (sets of episodes) based on fetched public media resources.
This project provides a backend (API service) and is positioned as an updated version of podcast application.

• Project Description
• Install Project
• Run Project
• Useful Commands
• Env Variables
• License

This application can be used for creation your podcasts.
If you have any sounds (or youtube videos as example) which you want to listen later, you can create podcast (via web interface) and attach your tracks to it
Created podcast (with prepared episodes) will have a direct link (to RSS feed), which can be used for adding your podcast to same podcast application (Add by URL)
Adding and downloading each new episodes will refresh RSS-feed and your APP will be able to get them.

• python 3.11
• Starlette
• RQ (background tasks)
• yt-dlp (download audio tracks from external media platforms)
• redis (key-value storage + RQ)
• ffmpeg (audio postprocessing)

Technically project contains from 3 parts:

• AUTH service (JWT-based)
• PODCAST service (CRUD API for podcasts/episodes)
• Some tools and engines for fetching episodes from external resources (youtube as for now)

• episodes
• generated RSS feeds

• download sounds from requested resource
• perform sound and prepare mp3 files with ffmpeg
• generate RSS feed file (xml) with episodes (by specification https://cyber.harvard.edu/rss/rss.html)

cd "<PATH_TO_PROJECT>"
cp .env.template .env
# update variables to actual (redis, postgres, etc.)

export $(cat .env | grep -v ^# | xargs)
docker run --name postgres-etc -e POSTGRES_PASSWORD=${DATABASE_PASSWORD} -d postgres:10.11
docker run --name redis-etc -d redis

export $(cat .env | grep -v ^# | xargs)
PGPASSWORD=${DATABASE_PASSWORD} psql -U${DATABASE_USER} -h${DATABASE_HOST} -p${DATABASE_PORT} -c "create database ${DATABASE_NAME};"

cd "<PATH_TO_PROJECT>" && make migrations_upgrade

• Run via docker-containers (like in production mode)

cd "<PATH_TO_PROJECT>" && docker-compose up --build

• Run in develop-mode

# install pipenv https://pypi.org/project/pipenv/
cd "<PATH_TO_PROJECT>"
pipenv install --dev
make run_web
# or 
make run_rq

• work with migrations

make migrations_create_auto   # auto-creation
make migrations_create_manual # manual-creation
make migrations_upgrade       # apply all migrations
make migrations_downgrade     # unapply with param `revision=1231`
make migrations_history       # show applied migrations

• Run tests

cd "<PATH_TO_PROJECT>"/src && pytest 

• Apply formatting (black) and lint code (pylint)

make lint

This product is released under the MIT license. See LICENSE for details.