Django Podcast Analyzer

A simple Django app that allows you to follow the feeds of various podcasts and glean interesting information from them.

Warning

This is early stage! Things that still need to be done:

• Better handling of duplicate people discovered from multiple feeds
• Improved docs.

Installation

Via pip:

python -m pip install django-podcast-analyzer

Via uv:

uv pip install django-podcast-analyzer

Then add it and our dependencies to your list of installed apps.

# settings.py

# Your setup may vary.
INSTALLED_APPS = [
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.sites",
    "django.contrib.messages",  # Optional
    "django.contrib.staticfiles",
    "django.contrib.admin",
    "django.forms",
    ...,
    # Here are our explict dependencies
    "tagulous",
    "django_q",
    "podcast_analyzer",
]

We use tagulous for tagging podcasts and django-q2 to handle the scheduled tasks related to fetching feeds and processing them. See the documentation for both of those projects to identify any additional configuration needed.

Add it to your urls.py:

# Your root urls.py

from django.urls import include, path

urlpatterns = [
    ...,
    path("podcasts/", include("podcast_analyzer.urls", namespace="podcasts")),
    ...,
]

Then run your migrations.

python manage.py migrate

You'll also want to seed the database with the known iTunes categories for podcasts. You can do this via the provided management command. It will only do so if the respective tables are empty so you won't get duplicates.

python manage.py seed_database_itunes

In order to run the application, you will also need to spawn a django-q cluster using python manage.py qcluster. You can also use a runner like honcho or a Supervisor app.

Other Recommendations

For storage of podcast art and other media, it's recommended you consider using something like django-storages.

Development

Contributions are welcome! See our contributing guide for details.