licchart 0.0.3

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

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 exit	None	None
-v, --version	Prints out current version	None	None
-a KEY, --api KEY	Changes API key	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	Float	Dynamic value
-f FPS, --fps FPS	More frames take more time to generate, but provide a smoother animation	Integer	30