licchart 0.0.6

A Last.fm Bar Chart Race Maker

LICCHART

A CLI tool to make Last.fm bar chart race animations

Installation

Linux

Make sure you have Python and pip (use your own package manager!):

sudo apt-get install python3

Install ffmpeg:

sudo apt-get install ffmpeg

Install/update LICCHART:

pip install --upgrade licchart

macOS

Install Homebrew package manager:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Make sure you have Python and pip:

brew install python 

Install ffmpeg:

brew install ffmpeg

Install/update LICCHART:

pip install --upgrade licchart

Windows

Install Python:

• Make sure to tick a box "Add Python to PATH"

Install ffmpeg:

• Download latest build
• Unzip all files inside the folder C:\ffmpeg
• Run cmd as administrator
• Run the following command: setx /m PATH "C:\ffmpeg\bin;%PATH%"
• You might need to restart your PC afterwards

Install/update LICCHART:

pip install --upgrade licchart

Setting API key

In order to fetch scrobbles from Last.fm, you need to create a Last.fm API key

You can specify what API key LICCHART should use with:

licchart --api KEY

Uninstalling

Uninstall LICCHART

pip uninstall licchart

Uninstall dependencies with package manager you used to install them

Usage

Using LICCHART is straightforward, just pass in your Last.fm username!

licchart USERNAME

Once it's complete, you will see your generated video and CSV in a current directory

CSV file reduces time of your next data fetch

Customization

You can add arguments to your command to customize your chart generation

licchart -d -s 06/30/2022 -e July 1st 2022 --bars 10 --fps 60 -l 3.5

Command above generates a chart that:

• Processes each day (-d)
• Shows scrobbles from 06/30/22 til 07/01/22 (-s 06/30/2022 -e July 1st)
• Has 10 artists max (--bars 10)
• Has 60 FPS (--fps 60)
• Lasts 3.5 minutes (-l 3)

List of all arguments

Option	Description	Value type	Default
-h, --help	Shows help message in terminal and exits	None	None
-v, --version	Prints out current version and exits	None	None
-a KEY, --api KEY	Changes API key and exits	String	None
-m, --months	Takes less time to generate, but gives a less accurate result	None	Yes
-d, --days	Takes quite a while to generate, but gives very accurate result	None	No
-s DATE, --strt DATE	Sets starting date	Date String	Your first scrobble
-e DATE, --end DATE	Sets ending date	Date String	Your last scrobble
-b AMOUNT, --bars AMOUNT	Sets how many artists will be visible on the chart	Integer	20
-l MIN, --length MIN	Sets how long your animation will be	Decimal	Dynamic value
-f FPS, --fps FPS	More frames take more time to generate, but provide a smoother animation	Integer	30