ascii.fm

A command-line tool for displaying album art from last.fm music data.

Description

Users can retrieve the album art of their most recently played track, or search by album and artist. Album art is displayed in the terminal using ascii_magic.

Features

• Retrieve the most recently played track for a specified last.fm user.
• Search by album and artist.
• Retrieve top album for a specified artist.
• Display album covers as ASCII art in the terminal.

Installation

1. Clone the repository:

   git clone https://github.com/marlyr/ascii.fm.git
   cd ascii.fm

2. Install the required packages:

   pip install -r requirements.txt

3. Create an API key for last.fm.

4. Create a .env file in the project directory and add your last.fm API key:

   API_KEY=your_last_fm_api_key
   

Usage

Display the most recently played track for a user

python asciifm.py --username your_last_fm_username

Search for an album

python asciifm.py --album "Album Name"

Search for an artist's top album

python asciifm.py --artist "Artist Name"

Search for a specific album by a specific artist

python asciifm.py --album "Album Name" --artist "Artist Name"