Django Cast

A blogging/podcasting package based on Django and Wagtail.

Documentation: django-cast.readthedocs.io

Getting Started

• New project: install django-cast, then use the quickstart installation guide and run uv run django-cast-quickstart mysite
• Existing Django project: follow the integration installation guide
• Local development on django-cast itself: see the development guide

Key Features

• Responsive images
• Wagtail as CMS makes it possible for non-technical people to manage the content (blog posts, podcast episodes, ...)
• Podcast support: this package powers python-podcast.de since 2018 using the Podlove Web Player
• Video support - not as sophisticated as image / audio support, but it works 🤗
• Comments via django-contrib-comments with a built-in moderating spam filter
• Code blocks for the Wagtail page editor
• Use Twitter Player Card for links to podcast episode detail pages
• Tags and categories for posts which are then included in the faceted navigation UI (beta feature)
• Frontend themes to customize the look and feel of your site

Deployment

See the deployment documentation.

Upgrade note (0.2.57)

Repository alias names were removed in a breaking cleanup. Use canonical names only.

• QuerysetData -> PostQuerySnapshot
• PostDetailRepository -> PostDetailContext
• BlogIndexRepository -> BlogIndexContext
• FeedRepository -> FeedContext
• EpisodeFeedRepository -> EpisodeFeedContext
• audio_to_dict -> serialize_audio
• video_to_dict -> serialize_video
• image_to_dict -> serialize_image
• blog_to_dict -> serialize_blog
• blog_from_data -> deserialize_blog
• post_to_dict -> serialize_post
• episode_to_dict -> serialize_episode
• transcript_to_dict -> serialize_transcript

Backlog

Planned work is tracked in BACKLOG.md, which is the canonical place for planned work, research notes, and future cleanup ideas.

Contributing

If you'd like to contribute, please read our contributing docs.