ngc / last-display

A 100% customizable live album art and music display

The last display for your music player you'll ever need.

Table of Contents

• About the Project
• Getting Started
  • Prerequisites
  • Installation
• Usage
• License

About

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.

Getting Started

To get a local build up and running, follow these steps.

Prerequisites

• Python3.8
• Git
• chromium-browser
• A last.fm account
  • last.fm API key

To install the software requirements on Ubuntu or Debian, run this command.

sudo apt install python3.8 git chromium-browser python3-pip python3-dotenv

Installation

1. Clone the repo

git clone https://github.com/thaniel-c/last-display.git
cd last-display/

2. Install requirements

pip3 install -r requirements.txt 

3. Install API Key

chmod +x install.sh && ./install.sh

Usage

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.

Debugging

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"

---

License

Distributed under the GNU GPL. See LICENSE for more information.