Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


audio-feeder is a Flask-based web-app that hosts your audiobooks (or other audio content) as RSS feeds compatible with podcatchers.


Currently, there is no installer that will install things "correctly", so you should look into the proper way to deploy this web app. In 'development mode', you can install it using these steps:

  • Download the source code, cd into the extracted directory.
  • In your virtualenv, run pip install .
  • Run audio-feeder install - this should create a basic {{CONFIG}} directory in /etc/audio_feeder or ~/.config/audio_feeder
  • Modify the configuration files in {{CONFIG}}/config.yml as desired.
  • Modify the templates and CSS files as desired.
  • Create a symbolic link to your audiobooks directory under {{CONFIG}}/static/media/ (e.g. ~/.config/audio_feeder/static/media/audiobooks) - we'll call this {{AUDIOBOOKS}}.
  • Run audio-feeder update {{AUDIOBOOKS}} to pull metadata from Google Books (for a large number of audiobooks, you may need to get a Google API key, which should be entered in your config.yml page under google_api_key).
  • Run the server with audio-feeder run
  • Visit your page at localhost:9090 (default value). Note: You should specify your computer's specific IP address if you are planning on serving your audiobooks directly to a phone or device over wifi.

If you add more audiobooks to your audiobook path, run audio-feeder update {{AUDIOBOOKS}} again and restart the application.


Version 0.1.0 is a very rough initial cut, and if you're looking for something easy to use out of the box, you may have to wait a bit longer. The odd choice of using YAML files as a pseudo-database is not intended to be permanent, and these will be replaced with a proper database soon.


The following dependencies are required for installation, and will be installed if missing when installed through pip:

  • Flask
  • ruamel.yaml
  • qrcode
  • Pillow
  • requests
  • jinja2
  • click
  • progressbar2

To run the test suite, pytest is also required.


All images and documentation contained herein are licensed under CC-0.

The code is released under the Apache 2.0 license.


Pull requests and issues are more than welcome. Please be aware that your contributions will be released under the licenses stated above. If you are not comfortable with that, please do not make a pull request.


A server that loads your audiobooks and creates RSS feeds so that they can be loaded as podcasts.




No releases published


No packages published
You can’t perform that action at this time.