Bandcamp Newsfeed RSS Feed Generator

FastAPI RSS Feed Generator for your Bandcamp newsfeed

Makes RSS feed out of your https://bandcamp.com/{BANDCAMP_USERNAME}/feed, so you can follow the new releases using your favorite RSS reader

Features

• Converts Bandcamp newsfeed to RSS/Atom feeds
• Embeds the entry HTML into the RSS entry
• Configurable caching
• Health check endpoint for monitoring
• Optional pre-order filtering (API source only)

Usage

1. Get your Bandcamp identity cookie (described below)
2. Create .env file with required variables (described below)
3. Run locally or deploy using one of the methods described below

Configuration

• Create .env file using .env.example

# "identity" cookie from Bandcamp (required for private feeds)
IDENTITY=7%09ABCV1A%2B12D12D12ABCDEJbOCvA8Mfi90betEmFcYfhs%3D%09%7B%22id%22%3A135750916%2C%22ex%22%3A0%7D

BANDCAMP_USERNAME=my_bandcamp_username

PORT=8000
CACHE_DURATION_SECONDS=3600
TZ=Europe/Kyiv

# Filter out pre-order items from the feed (API source only)
BANDCAMP_FILTER_PREORDERS=0

VERBOSE=0

Getting Your Bandcamp Identity Cookie

1. Log into Bandcamp in your browser
2. Open Developer Tools (F12)
3. Go to Network tab
4. Visit your feed page: https://bandcamp.com/YOUR_USERNAME/feed
5. Look for the request to this URL
6. In the request headers, find the Cookie header
7. Copy the identity=... value

Endpoints

• /rss - RSS 2.0 feed
• /atom - Atom feed
• /health - Health check

Query Parameters

Both /rss and /atom endpoints support the following query parameter:

Parameter	Type	Default	Description
source	string	scraping	Source type. Described below.

Source Types

Source	Description
scraping	Default. Uses web scraping to parse the Bandcamp feed page HTML.
api	Uses the Bandcamp API to fetch the feed.

Examples

• http://127.0.0.1:8000/rss — Default scraping source (RSS)
• http://127.0.0.1:8000/atom — Default scraping source (Atom)
• http://127.0.0.1:8000/rss?source=api — Using Bandcamp API source (RSS)
• http://127.0.0.1:8000/atom?source=api — Using Bandcamp API source (Atom)

Running locally

• Install uv
• Pre-create .env in your Home directory from .env.example
• Run the project

uvx --from https://github.com/ALERTua/bandcamp_newsfeed_rss bandcamp_newsfeed_rss

Docker Deployment

Building the image and running the container

# Build the image
docker build -t bandcamp_newsfeed_rss .

# Run the container using .env file
docker run -p 8000:8000 --env-file .env bandcamp_newsfeed_rss

# Or run the container using the environment variable arguments
docker run -p 8000:8000 \
  -e BANDCAMP_USERNAME=your_username \
  -e IDENTITY=your_identity_cookie \
  -e TZ=Europe/Kiev \
  bandcamp_newsfeed_rss

Using the pre-built image

# Run the container using .env file
docker run -p 8000:8000 --env-file .env ghcr.io/alertua/bandcamp_newsfeed_rss

# Or run the container using the environment variable arguments
docker run -p 8000:8000 \
  -e BANDCAMP_USERNAME=your_username \
  -e IDENTITY=your_identity_cookie \
  -e TZ=Europe/Kiev \
  ghcr.io/alertua/bandcamp_newsfeed_rss

Troubleshooting

Feed not loading?

• Verify your BANDCAMP_USERNAME is correct
• Check that your identity cookie is valid (not expired)
• Ensure you have access to the Bandcamp feed

Empty feed?

• Check if your Bandcamp feed has any items
• Verify cookie permissions for private content

Docker issues?

• Ensure .env file exists in the current directory
• Check port 8000 is not already in use

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request