Radio Balises is a local radio that broadcasts in the Lorient area in France. The website of the radio offers a list of the last 10 songs, no more. There is no way to search for a song that was broadcast on a particular date, except for those last 10 songs.

The goals for this toy project are:

parse the 'last 10 songs' page and store them in a database ;
offer a simple web interface to search songs played on a particular date, if they are stored in the database.

Ideally, the 'last 10 songs' list should be regularly retrieved, so that the database is complete enough to be useful. Then, I may be able to find out what was that song that I heard 3 days ago while I was driving.

Requirements

This project is written in Python and uses the following libraries:

requests: to retrieve the 'last 10 songs' page;
beautiful soup: to parse that page;
peewee: a simple ORM, to store and query the data in a SQL database;
bottle: a micro web framework.

Those libraries are all packaged in Debian and can be installed with:

apt install python3-request python3-bs4 python3-peewee python3-bottle

It also needs a MySQL server (although switching to another database should be easy).

Installation

We suppose the repository is cloned under /opt/balises.

Create a balises.py config file, and fill in MySQL credentials. You can use `balises.ini.example as a starting point.

To update the database every 15 minutes, the following line can be installed as a cronjob:

*/15 * * * * /opt/balises/balises.py update

To launch the server automatically, you can install and use the systemd service file :

ln -s /opt/balises/balises.service /etc/systemd/system/balises.service
systemctl enable balises.service
systemctl start balises.service

The server listens to port 9980 on localhost by default, unless otherwise specified in the config file. Setting up a reverse proxy and ssl is left as an exercise to the reader.