The last display for your music player you'll ever need.
The most inconsistent thing across music players is how the album art is displayed. last.display takes advantage of last.fm's API to quickly get information about what music the user is currently playing, or what music they listen to in general.
Last.display is also 100% customizable. It comes with a premade template called template.html
, but the user is encouraged to change it and style it to their liking. Information is passed into the template through format strings.
Since last.display is powered by Chromium, it is fully responsive and can be displayed in any form you'd like. Although, it is originally made to work best with tiling window managers such as i3.
To get a local build up and running, follow these steps.
- Python3.8
- Git
- chromium-browser
- A last.fm account
To install the software requirements on Ubuntu or Debian, run this command.
sudo apt install python3.8 git chromium-browser python3-pip python3-dotenv
- Clone the repo
git clone https://github.com/thaniel-c/last-display.git
cd last-display/
- Install requirements
pip3 install -r requirements.txt
- Install API Key
chmod +x install.sh && ./install.sh
To run last.display, execute the following commands.
chmod +x run.sh
./run.sh USERNAME
If everything was correctly installed you should see a small window popup with the most recent track you played showing.
There's a chance the server didn't correctly run because there is already a process active on port 8099
. To fix this problem, simply kill the process on that port or change the port in line 15 of main.py
to something else.
There's a good chance you'll want to do some debugging when making your own changes to last.display. To see stdout, run the following commands to start last.display along with chromium-browser.
python3.8 main.py --user USERNAME
chromium-browser --app="http://0.0.0.0:8099/__display__.html"
Distributed under the GNU GPL. See LICENSE
for more information.