Package: audio-feeder
audio-feederis a Flask-based web-app that hosts your audiobooks (or other audio content) as RSS feeds compatible with podcatchers.FeaturesThe main interface lists all your audiobooks once the database is updated (either by usingaudio-feederupdateor by visiting the/updateurl. The default interface should also work well on mobile:Rendered feedsFor each entry,audio-feedercan also generate “rendered” feeds, depending on what metadata is available:Single file: This feed consists of a single file; if the original directory contains multiple files, they will be merged together usingffmpeg. If chapter information is not available in the original files, each file will be considered a separate “chapter”.Chapters: This feed has one file per chapter; it is only available if explicit chapter metadata is available in the file (e.g. in anm4bfile, or using Overdrive MediaMarkers).Segmented: This is a feed that splits up and recombines files in such a way as to create files that are ~1 hour long (preferring longer files to shorter files). Files will only be split up along chapter boundaries, but they can be combined from files without chapter information. This mode is available if the original entry has more than one file, or if it has chapter information (or both).QR CodesEach feed has an associated QR code, so that you can easily browse the list from a computer, but scan the individual feeds from your phone. In the default front-end, QR codes are displayed via modal pop-ups:Display optionsThe user can customize things like the sort order and the number of entries per page:Installation and useProbably the easiest way to deploy this is via docker. For your convenience, I have createda repository with a docker-compose configuration. It usesnginxto serve static media files, andgunicornto deploy the application.If you want to test it out locally, you can usetox-estart_serverto run a test server. This will create a temporary server directory at/tmp/audio_feeder_server, and you can play around with, and you can mount your audiobook directory at/tmp/audio_feeder_server/static/mediato have it work on your own audiobooks (bind mount, symlink or hard link should work just fine).In avirtualenvwithaudio-feederinstalled, you can runaudio-feeder--helpto see the various command line tools bundled with the application.NoteWhile the state of this is getting much closer to something production-ready, I am emphaticallynota 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.DependenciesIn addition to the python dependencies specified inpyproject.toml, this project also requires installingffmpegwith at least theaaccodec, and the tests also require thelibmp3lamecodec.LicenseAll images and documentation contained herein are licensed underCC-0.The code is released under theApache 2.0license.ContributingPull 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.