FolderCast
- 0 ratings
a self-hosted web app that generates podcast-ready RSS feeds from your local audio folders.
Self-host this app for $0.99/mo only!
FolderCast is a self-hosted web app that generates podcast-ready RSS feeds from your local audio folders. It scans your chosen library directories, generates standard podcast feeds, and gives you a unique link (and QR code) for each one. Simply add that link to your favorite podcast player and stream your personal audio collection (lectures, YouTube downloads, audiobooks, or voice notes) just like a regular podcast. Everything runs locally and stays fully under your control.
You probably have some or all of the following:
You’d like to listen to these on the go (in the car, while walking, cooking, or doing chores). Sure, you could copy them to your phone and use a regular audio player, but that quickly becomes a hassle. And once you do, you realize most music players aren’t built for long-form listening. They:
So, maybe you try a podcast app instead: Perfect for long content, bookmarking, and smart playback, but now you face another problem: how do you get your personal audio files into your podcast player?
That’s where FolderCast comes in.
FolderCast automatically generates standard podcast RSS feeds for your audio folders. Each folder becomes its own podcast, and each audio file within it appears as an episode. You can manually subscribe to the feed in any podcast player (copy/paste feed URL, or simply scan its QR code with your phone). Your private “podcasts” appear right alongside your regular subscriptions, but they’re hosted locally, accessible only from your own network.
This gives you all the power of a modern podcast player, including:
That's what listening on a regular podcast player app gives you. But to get there, FolderCast offers you a set of features.
FolderCast runs entirely in Docker using Docker Compose, so you don’t need to install Python or dependencies on your host.
git clone https://github.com/ahmedlemine/foldercast.git
cd foldercastFolderCast stores all your audio folders, generated feeds, QR codes, and artwork inside a local directory called library.
Create it manually in foldercast directory (recommended) and make sure it's owned by your current user:
mkdir -p ./library
chown $USER:$USER ./libraryCopy the example .env file and update values as needed:
cp example.env .envAt minimum, set your Django secret key (get a new one at Djecrety):
SECRET_KEY=your-secret-key
CSRF_TRUSTED_ORIGINS=<http://<your_server_ip>:<server_port>docker compose up -d --buildThis will:
app container (Django + Gunicorn)nginx to serve static/media files and reverse proxy to Django./library/ directory if it doesn’t exist. However, you should've already created this directory in step #2 to avoid permission issues.Once running, open your browser and visit:
http://<you_host_ip>:8123Stop the stack:
docker compose downRestart after changes:
docker compose up -dFolderCast is focused on doing one thing, and doing it well: turning your audio folders into podcast-ready RSS feeds.
It’s not trying to be a media server, a cloud sync tool, or a file uploader. Its goal is simplicity, reliability, and staying true to its purpose: generating clean, standard feeds for your audio collection.
If you find bugs, have suggestions that directly improve that core purpose, or want to share how you’re using FolderCast, contributions and feedback are very welcome.
You can:
Please login to review this project.
No reviews for this project yet.
Music browsing and streaming application optimized for larg…
Self-hosted music scrobble database, alternative to Last.fm.
Modern Music Server and Streamer, compatible with Subsonic/…
Comments (0)
Please login to join the discussion on this project.