Fix/hls fallback host

CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## Unreleased
+
+### Changed
+
+- Formatted the Python source with Black.
+- Normalized import ordering with isort.
+- Corrected PEP 8 whitespace, indentation, quoting, and `None` comparison style.
+- Preserved the existing public camelCase APIs to avoid breaking current callers.
+- Git commits for updates are now signed with GPG.
+- Added a cached JPEG artwork proxy for formats such as WebP, with download,
+  image-size, redirect, and private-address protections.
+- Added channel-level iTunes artwork, News category, non-explicit status, and
+  episodic show type metadata.
+
+### Validation
+
+- Python bytecode compilation, formatter, import-order, pycodestyle, whitespace,
+  and focused utility smoke checks pass.
+- **Not fully tested:** the application has not undergone end-to-end or live Podimo
+  API testing. The artwork and feed test suite passes, and the application starts
+  successfully with the configured Hypercorn server.

Dockerfile

@@ -3,7 +3,7 @@ FROM python:3.10-alpine
 WORKDIR /src
 
 COPY requirements.txt /src/
-RUN apk add libxml2-dev libxslt-dev gcc libc-dev && pip3 install --no-cache-dir -r requirements.txt
+RUN apk add libxml2-dev libxslt-dev jpeg-dev zlib-dev libwebp-dev gcc libc-dev && pip3 install --no-cache-dir -r requirements.txt
 
 COPY . /src
 

README.md

@@ -55,6 +55,14 @@ docker run --rm \
 
 3. Visit http://localhost:12104. You should see the site now!
 
+## HLS fallback audio
+
+Podcast clients without HLS support receive an episode-specific URL such as
+`/audio/dummy-<hash>.mp3` as their standard RSS enclosure. Every generated URL
+serves the same physical fallback file at `audio/dummy.mp3`. The legacy
+`/audio/dummy.mp3` URL remains available. A reverse proxy may expose these URLs
+under a prefix such as `/pc/audio/`.
+
 ## Configuration
 A complete list of all configuration options can be found in the [.env.example file](.env.example)
 

audio/.gitkeep

@@ -0,0 +1 @@
+