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.Authenticate on Last.fm
Click the link in your DMs and approve the connection on the Last.fm website.
Commands
lastfm login
lastfm login
Link your Last.fm account via OAuth. Sends a DM with a personalized authentication link.Aliases:
lfm loginlastfm logout
lastfm logout
Unlink your Last.fm account from the bot.Aliases:
lfm logoutlastfm np
lastfm np
Show what you or another user is currently listening to (or last played). Displays track name, artist, album, artwork, and your personal play count.Aliases:
lfm np, lfm nowplayinglastfm recent
lastfm recent
Show the last 10 tracks played by you or another user, with the currently playing track highlighted.Aliases:
lfm r, lfm recentlastfm artist
lastfm artist
Show detailed info about an artist including global listener count, scrobbles, genre tags, bio, and your personal play count.Aliases:
lfm a, lfm artistlastfm album
lastfm album
Show info about an album including your play count, track count, and genre tags. Use Aliases:
Artist - Album format or omit the artist to pull from your currently playing track.lfm al, lfm albumlastfm track
lastfm track
Show info about a track including your play count, duration, and genre tags. Use Aliases:
Artist - Track format or omit the artist to pull from your currently playing track.lfm tr, lfm tracklastfm collage
lastfm collage
Generate a grid of your top album artwork. Supports custom grid sizes from 1×1 to 5×5 and all standard time periods.Aliases:
lfm col, lfm collage
Periods: overall 7day 1month 3month 6month 12monthlastfm topartists
lastfm topartists
Show your top 10 artists for a given time period with play counts.Aliases:
lfm ta, lfm topartists
Periods: overall 7day 1month 3month 6month 12monthlastfm toptracks
lastfm toptracks
Show your top 10 tracks for a given time period with play counts.Aliases:
lfm tt, lfm toptracks
Periods: overall 7day 1month 3month 6month 12monthlastfm topalbums
lastfm topalbums
Show your top 10 albums for a given time period with play counts.Aliases:
lfm tab, lfm topalbums
Periods: overall 7day 1month 3month 6month 12monthlastfm profile
lastfm profile
Show a user’s Last.fm profile stats including total scrobbles, unique artists, albums, tracks, registration date, and country.Aliases:
lfm p, lfm profilelastfm scrobbles
lastfm scrobbles
Show total scrobble count with daily and weekly averages and the date scrobbling began.Aliases:
lfm sc, lfm scrobbleslastfm milestone
lastfm milestone
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.Milestones: 1K · 5K · 10K · 25K · 50K · 100K · 250K · 500K · 1MAliases:
lfm milestonelastfm streak
lastfm streak
Show your current consecutive daily listening streak and today’s scrobble count.Aliases:
lfm streaklastfm cover
lastfm cover
Display the full-size album artwork for your current or last played track.Aliases:
lfm coverlastfm chart
lastfm chart
Display a visual bar chart of your top artists, tracks, or albums for a given period.Aliases:
lfm chart
Periods: overall 7day 1month 3month 6month 12monthlastfm toptags
lastfm toptags
lastfm taste
lastfm taste
Compare your music taste with another server member. Shows compatibility percentage and top shared artists with play count breakdowns for each user.Aliases:
lfm tastelastfm compare
lastfm compare
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.Aliases:
lfm comparelastfm whoknows
lastfm whoknows
See which server members have listened to a given artist the most. The top listener earns the crown.Aliases:
lfm wk, lfm whoknowslastfm whoknowstrack
lastfm whoknowstrack
See which server members have listened to a specific track the most. Use Aliases:
Artist - Track format.lfm wkt, lfm whoknowstracklastfm whoknowsalbum
lastfm whoknowsalbum
See which server members have listened to a specific album the most. Use Aliases:
Artist - Album format.lfm wka, lfm whoknowsalbumlastfm mostcrowns
lastfm mostcrowns
Server leaderboard showing who holds the most #1 listener spots (crowns) across all artists tracked in the server.Aliases:
lfm mc, lfm mostcrownsFeature 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:| Argument | Period |
|---|---|
overall / alltime | All Time |
7day / weekly | Last 7 Days |
1month / monthly | Last Month |
3month | Last 3 Months |
6month | Last 6 Months |
12month / yearly | Last 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
- Discord ID
- Last.fm Username
Mention a Discord user directly. Their linked Last.fm account will be used automatically.
Album Collage
Thecollage command generates a canvas image of your top albums for a given period.
- Grid size: Any value from
1x1to5x5. Defaults to3x3. - 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.
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.Command Aliases Reference
| Full Command | Aliases |
|---|---|
lastfm | lfm |
lastfm np | lfm np, lfm nowplaying |
lastfm recent | lfm r |
lastfm artist | lfm a |
lastfm album | lfm al |
lastfm track | lfm tr |
lastfm collage | lfm col |
lastfm topartists | lfm ta |
lastfm toptracks | lfm tt |
lastfm topalbums | lfm tab |
lastfm profile | lfm p |
lastfm scrobbles | lfm sc |
lastfm streak | lfm streak |
lastfm milestone | lfm milestone |
lastfm cover | lfm cover |
lastfm chart | lfm chart |
lastfm taste | lfm taste |
lastfm compare | lfm compare |
lastfm whoknows | lfm wk |
lastfm whoknowstrack | lfm wkt |
lastfm whoknowsalbum | lfm wka |
lastfm mostcrowns | lfm mc |
lastfm toptags | lfm tags |