Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.celestia.rest/llms.txt

Use this file to discover all available pages before exploring further.

Overview

The Last.fm integration allows users to link their Last.fm accounts and access a full suite of music tracking commands directly within Discord. From checking what’s currently playing to comparing music tastes with other server members, the system provides real-time scrobble data, artist info, collage generation, server-wide leaderboards, and more — all rendered with a clean, interactive interface using Discord Components V2.

Getting Started

Before using any Last.fm commands, you must link your account using OAuth authentication.
1

Run the login command

Use ~lastfm login to receive a DM with your personal authentication link.
2

Authenticate on Last.fm

Click the link in your DMs and approve the connection on the Last.fm website.
3

You're linked

Your account is linked automatically once you approve. You can now use all Last.fm commands.
Make sure your DMs are open from server members so the bot can send you the login link.

Commands

Link your Last.fm account via OAuth. Sends a DM with a personalized authentication link.
~lastfm login
Aliases: lfm login
Unlink your Last.fm account from the bot.
~lastfm logout
Aliases: lfm logout
Show what you or another user is currently listening to (or last played). Displays track name, artist, album, artwork, and your personal play count.
~lastfm np [@user/username]
Aliases: lfm np, lfm nowplaying
Show the last 10 tracks played by you or another user, with the currently playing track highlighted.
~lastfm recent [@user/username]
Aliases: lfm r, lfm recent
Show detailed info about an artist including global listener count, scrobbles, genre tags, bio, and your personal play count.
~lastfm artist <name> [@user]
Aliases: lfm a, lfm artist
Show info about an album including your play count, track count, and genre tags. Use Artist - Album format or omit the artist to pull from your currently playing track.
~lastfm album <Artist - Album> [@user]
Aliases: lfm al, lfm album
Show info about a track including your play count, duration, and genre tags. Use Artist - Track format or omit the artist to pull from your currently playing track.
~lastfm track <Artist - Track> [@user]
Aliases: lfm tr, lfm track
Generate a grid of your top album artwork. Supports custom grid sizes from 1×1 to 5×5 and all standard time periods.
~lastfm collage [NxN] [@user] [period]
Aliases: lfm col, lfm collage Periods: overall 7day 1month 3month 6month 12month
Show your top 10 artists for a given time period with play counts.
~lastfm topartists [@user] [period]
Aliases: lfm ta, lfm topartists Periods: overall 7day 1month 3month 6month 12month
Show your top 10 tracks for a given time period with play counts.
~lastfm toptracks [@user] [period]
Aliases: lfm tt, lfm toptracks Periods: overall 7day 1month 3month 6month 12month
Show your top 10 albums for a given time period with play counts.
~lastfm topalbums [@user] [period]
Aliases: lfm tab, lfm topalbums Periods: overall 7day 1month 3month 6month 12month
Show a user’s Last.fm profile stats including total scrobbles, unique artists, albums, tracks, registration date, and country.
~lastfm profile [@user/username]
Aliases: lfm p, lfm profile
Show total scrobble count with daily and weekly averages and the date scrobbling began.
~lastfm scrobbles [@user/username]
Aliases: lfm sc, lfm scrobbles
View your scrobble milestone progress. Shows your last reached milestone and the next one, with an estimated number of days to reach it based on your daily average.
~lastfm milestone [@user/username]
Milestones: 1K · 5K · 10K · 25K · 50K · 100K · 250K · 500K · 1MAliases: lfm milestone
Show your current consecutive daily listening streak and today’s scrobble count.
~lastfm streak [@user/username]
Aliases: lfm streak
Display the full-size album artwork for your current or last played track.
~lastfm cover [@user/username]
Aliases: lfm cover
Display a visual bar chart of your top artists, tracks, or albums for a given period.
~lastfm chart [artists/tracks/albums] [period]
Aliases: lfm chart Periods: overall 7day 1month 3month 6month 12month
Show your most listened genre tags with a proportional visual bar chart.
~lastfm toptags [@user/username]
Aliases: lfm tags, lfm toptags
Compare your music taste with another server member. Shows compatibility percentage and top shared artists with play count breakdowns for each user.
~lastfm taste <@user>
Aliases: lfm taste
Deep music comparison with another user. Shows compatibility, shared artist count, total scrobbles for each user, top shared artists, and artists unique to each user.
~lastfm compare <@user>
Aliases: lfm compare
See which server members have listened to a given artist the most. The top listener earns the crown.
~lastfm whoknows <artist>
Aliases: lfm wk, lfm whoknows
See which server members have listened to a specific track the most. Use Artist - Track format.
~lastfm whoknowstrack <Artist - Track>
Aliases: lfm wkt, lfm whoknowstrack
See which server members have listened to a specific album the most. Use Artist - Album format.
~lastfm whoknowsalbum <Artist - Album>
Aliases: lfm wka, lfm whoknowsalbum
Server leaderboard showing who holds the most #1 listener spots (crowns) across all artists tracked in the server.
~lastfm mostcrowns
Aliases: lfm mc, lfm mostcrowns

Feature Overview

Now Playing

Real-time track display with artwork, album info, and personal play count

Top Charts

Visual bar charts for top artists, tracks, and albums across any time period

Album Collage

Auto-generated grid of your top album artwork, 1×1 up to 5×5

Who Knows

Server leaderboards for artists, albums, and tracks with crown rankings

Taste Comparison

Compatibility scores and shared artist breakdowns between two users

Milestones

Scrobble milestone tracking with ETA based on your daily average

Listening Streak

Consecutive daily listening streak tracker with today’s scrobble count

Full-Size Cover

Display the highest quality album artwork for your current track

Time Periods

Most commands that fetch top data support a time period argument. The following periods are accepted:
ArgumentPeriod
overall / alltimeAll Time
7day / weeklyLast 7 Days
1month / monthlyLast Month
3monthLast 3 Months
6monthLast 6 Months
12month / yearlyLast Year
If no period is specified, commands default to overall (All Time), except chart which defaults to 7day.

Targeting Other Users

Most commands support targeting another user in three ways:
Mention a Discord user directly. Their linked Last.fm account will be used automatically.
~lastfm np @user
~lastfm topartists @user weekly

Album Collage

The collage command generates a canvas image of your top albums for a given period.
  • Grid size: Any value from 1x1 to 5x5. Defaults to 3x3.
  • Period: Accepts any standard time period argument.
  • Artwork handling: Albums without artwork fall back to a letter placeholder on a dark background.
  • Cover fitting: All images are scaled to fill each cell evenly with no bleed between cells.
~lastfm collage 4x4 weekly
~lastfm collage 5x5 @user overall
~lastfm collage 3x3 1month
Generating larger collages (e.g. 5×5) may take a moment as artwork is fetched and rendered for each cell.

Server Commands

Some commands are scoped to the current server and require members to have their Last.fm accounts linked.

Who Knows

whoknows, whoknowstrack, whoknowsalbum — Ranks all linked server members by their play count for a given artist, track, or album. The top listener receives a crown.

Most Crowns

mostcrowns — Compares top artist ownership across all linked members and shows a full server leaderboard of crown holders.
Server-wide commands like whoknows and mostcrowns require fetching data for every linked member. This may take some time in larger servers.

Command Aliases Reference

Full CommandAliases
lastfmlfm
lastfm nplfm np, lfm nowplaying
lastfm recentlfm r
lastfm artistlfm a
lastfm albumlfm al
lastfm tracklfm tr
lastfm collagelfm col
lastfm topartistslfm ta
lastfm toptrackslfm tt
lastfm topalbumslfm tab
lastfm profilelfm p
lastfm scrobbleslfm sc
lastfm streaklfm streak
lastfm milestonelfm milestone
lastfm coverlfm cover
lastfm chartlfm chart
lastfm tastelfm taste
lastfm comparelfm compare
lastfm whoknowslfm wk
lastfm whoknowstracklfm wkt
lastfm whoknowsalbumlfm wka
lastfm mostcrownslfm mc
lastfm toptagslfm tags