Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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

Table of Contents

About last display

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

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/
  1. Install requirements
pip3 install -r requirements.txt 
  1. 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.

About

A 100% customizable live album art and music display

Topics

Resources

License

Releases

No releases published

Packages

No packages published