Skip to main content

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

The full documentation is at https://audio-feeder.readthedocs.io/.

Features

audio-feeder finds the books in a directory on disk, looks up their metadata from Google Books, and lists them in a web page that also works well on mobile, from which you can subscribe to each book’s feed.

  • Books can be browsed by the folders they’re organized in, and filtered by tag, language, author and the date they were added.

  • In addition to a feed of the files as they are on disk, each book can have “rendered” feeds generated with ffmpeg: the whole book merged into a single file, one file per chapter, or segments of about an hour each.

  • Each feed has a QR code, so that you can browse the list from a computer and scan the feed you want from your phone.

Installation and use

audio-feeder requires ffmpeg with at least the aac codec (the tests also require the libmp3lame codec). Install it with pip install audio-feeder or uv tool install audio-feeder, and create a server directory with:

$ audio-feeder install --config-dir ~/audiobook_server

Then put your books in ~/audiobook_server/static/media, and from ~/audiobook_server, load them into the database and start the server:

$ audio-feeder update
$ audio-feeder run

See the documentation for how to lay out your books, the configuration settings and how to deploy it. Probably the easiest way to deploy it is via Docker, using the docker-compose configuration in the audio_feeder_docker repository.

To try it out on some example books, run tox -e start_server from a checkout of this repository.

Note

While the state of this is getting much closer to something production-ready, I am emphatically not a front-end developer, and I don’t have extremely high confidence in the security of this project. Use at your own risk (and if you do come up with some security and/or usability improvements, please do send a PR).

This is only tested on Linux, but it may also work on other platforms.

License

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

The code is released under the Apache 2.0 license.

Contributing

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.

User-facing changes should come with a changelog entry, which is managed with scriv. Running tox -e changelog creates a new fragment in changelog.d/; uncomment the section for the kind of change (Features, Bugfixes or Misc; Major for changes that everyone upgrading needs to know about; or Breaking changes for changes that can break an existing installation or customization), describe the change in a sentence or two (in reStructuredText), ending with links to the pull request and any issues it fixes, and commit it with the rest of your changes. When a release is made, the fragments are collected into CHANGELOG.rst with tox -e changelog -- collect --version <version>, under a heading with the version and the release date (e.g. Version 0.6.2 (2022-12-03)). CI checks that every pull request adds a fragment; for changes that don’t need one (e.g. refactoring or CI changes), add the skip-changelog label to the pull request.

Metadata

Release files for audio-feeder 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for audio-feeder 0.7.0
File Size Uploaded Provenance Actions
audio_feeder-0.7.0.tar.gz 2.0 MB With provenance Details for audio_feeder-0.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for audio-feeder 0.7.0
File Interpreter ABI Platform Actions
audio_feeder-0.7.0-py3-none-any.whl Python 3 none any Details for audio_feeder-0.7.0-py3-none-any.whl

Total release size: 2.1 MB

Release files / audio_feeder-0.7.0.tar.gz

Download URL audio_feeder-0.7.0.tar.gz
Size 2.0 MB
Tags Source
SHA-256 checksum
How to use checksums
cc9b69c94f85cf143a90da83ac22edba2c36cfa91d8e8d7d249e2da3306e4fc4
BLAKE2b-256 checksum
How to use checksums
67d9735e00b475dfd1c5ae0152fd52b822e47bd89193295224ddeb949f0ab0d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.

Transparency log

Release files / audio_feeder-0.7.0-py3-none-any.whl

Download URL audio_feeder-0.7.0-py3-none-any.whl
Size 131.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c32e246051096209e71faee3d9468d5b9cce285614b3ff57ad4b2ed8682f4a06
BLAKE2b-256 checksum
How to use checksums
1643f22406bc235bef59dea1077c756b652b1d900faefb13046747b02e56847d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.

Transparency log

Security for audio-feeder 0.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for audio_feeder-0.7.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page