datasette-mp3-audio by simonw

25 downloads this week        Star

README source code


PyPI Changelog Tests License

Turn .mp3 URLs into an audio player in the Datasette interface


Install this plugin in the same environment as Datasette.

datasette install datasette-mp3-audio


Try this plugin at

The demo uses ScotRail train announcements from matteason/scotrail-announcements-june-2022.


Once installed, any cells with a value that ends in .mp3 and starts with either http:// or / or https:// will be turned into an embedded HTML audio element like this:

<audio controls src="... value ..."><a href="...">Download MP3</a></audio>

A "Play X MP3s on this page" button will be added to athe top of any table page listing more than one MP3.


To set up this plugin locally, first checkout the code. Then create a new virtual environment:

cd datasette-mp3-audio
python3 -m venv venv
source venv/bin/activate

Now install the dependencies and test dependencies:

pip install -e '.[test]'

To run the tests: