Home

Awesome

PodPeopleDB

PodPeopleDB is an open-source database for podcast hosts and guests, serving as the IMDB of podcasting. It automatically indexes podcast host information from podcast feeds and allows manual submissions of host/guest information.

Features

How It Works

PodPeopleDB uses the Podcast Index Feed ID to look up podcasts and automatically extracts host information from podcast feeds that use the podcasting 2.0 <podcast:person> tags. For podcasts without these tags, users can manually submit host information.

Data Structure

API Endpoints

GET /api/podcast/{id}     - Get podcast information by Podcast Index ID
GET /api/hosts/{id}       - Get hosts for a specific podcast
GET /api/recent-hosts     - Get recently added hosts
GET /api/download-database - Download the entire SQLite database

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/podpeople-db.git
  1. Build the Docker container:
docker build -t podpeople-db .
  1. Run the container:
docker run -p 8080:8080 podpeople-db

Environment Variables

Usage

  1. Access the web interface at http://localhost:8080
  2. Enter a Podcast Index Feed ID to look up a podcast
  3. View host information or submit new host details
  4. Download the database for offline use

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

Technologies Used

License

This project is open source and available under the GNU GENERAL PUBLIC LICENSE.

Acknowledgments

Security Note

Please make sure to change the default admin credentials in production by setting the appropriate environment variables.

ToDo

V1: