Skip to content

Getting started

.fmbot uses Last.fm to get information about your music taste. Don't have a Last.fm account? You can create one here.

For more information on connecting Last.fm to Spotify or other music services, please click here.

Note that .fmbot is not associated with Last.fm, we simply use their API. For issues with Last.fm you can check out their support forums or their unofficial Discord server.

Have an issue with the bot you need help with? Please check the Frequently Asked section first.

Text and slash commands

.fmbot works with text commands (.fm, typed in a channel where the bot is) and slash commands (/fm, picked from the menu that appears when you type /). Slash commands guide you through the options and also work in DMs and group chats when you add .fmbot to your account.

Use the . Text / / Slash switch at the top of every page to see the docs in the style you use. Commands that only exist in one form are marked. The .help/help command in Discord has the same switch.


.login

Allows you to sign up for Last.fm or to connect an existing Last.fm account to .fmbot.

If you changed your Last.fm account or username, you can also change it by simply connecting again.

Examples

.login

Examples

/login

Please note that users in shared servers will be able to see and request your Last.fm username.

To delete all your data from .fmbot, including friends and other settings, use .remove/remove.


.help

Shows an interactive help overview with popular commands, a category browser and details for every command. You can switch between text and slash commands with the buttons under the message.

Options:

  • Command - Name of a command or category to view details for
  • Private - Only show the response to you

Examples

.help

.help whoknows

.help crowns

Examples

/help

/help command:chart

You can also add help after any command to see its details, for example .chart help.


.profile

Shows you or someone else their user profile with some interesting statistics.

Options:

  • User - Select another user by mention, Discord ID or Last.fm username (lfm:username)

Examples

.profile

.stats

Examples

/profile

/profile user:frikandel_

⭐ Enhanced for .fmbot supporters

Want to see a graph of your listening history and a yearly overview on your profile? Get .fmbot supporter here.


.lastfm (.lfm)

Shows a link to your or someone else's Last.fm profile.

Options:

  • User - Select another user by mention, Discord ID or Last.fm username (lfm:username)
  • User - Select another user by mention, Discord ID or Last.fm username

Examples

.lfm

.lastfm

.lastfm @user

Examples

/lastfm

/lastfm user:frikandel_


.settings

Shows an overview of all your .fmbot settings.

Use the dropdown to pick what setting you want to change.

If you can manage the server, you can switch to the 'Server settings' tab with the buttons at the bottom.

Examples

.settings

Examples

/settings (responds in-channel)


.mode (.md)

Customize how .fmbot responds to you. Pick which mode you want to change:

  • .fm mode - How your fm command looks: embed type, embed color (the accent color), small text, buttons (max 1, or 5 for supporters), private button responses and footer options (max 4, or 10 for supporters)
  • Response mode - Your default layout (embed, image or pagination) for WhoKnows and top list commands
  • Album cover type - Whether album covers animate or always show as still
  • Graphs ⭐ - How your listening history graphs look, or turn them off

Use the provided dropdowns to select and de-select which options you want.

You can also open a section directly with .fmmode, .responsemode, .covermode or .graphmode.

You can override your response mode on every individual command. Simply add img, embed or pagination to the command.

You can override your response mode on every individual command with its mode option.

Examples

.mode

Examples

/mode (responds in-channel)

Override examples

.whoknows the beatles image

.toptracks 2023 img

.globalwhoknows mac miller pagination

Override examples

/wk artist:the beatles mode:Image

/gwk artist:mac miller mode:Pagination

⭐ Enhanced for .fmbot supporters

Supporters can set custom accent colors, add up to 5 buttons and 10 footer options, and unlock listening history graphs. Get .fmbot supporter here.


.userreactions ⭐

Sets automatic emoji reactions for every .fm and featured command you use.

To disable, simply use .userreactions without any emojis.

Make sure the emojis you enable are in a server that .fmbot is also in.

Max amount of emojis is 5. Please put a space between every emoji.

Examples

.userreactions :PagChomp: :PensiveBlob:

.userreactions 😀 😯 🥵

.userreactions 😀 😯 :PensiveBlob:

.userreactions

⭐ Exclusive for .fmbot supporters

Only supporters can set global emote reactions that override server settings. Get .fmbot supporter here.


/localization

Configure your timezone and number format in .fmbot.

Setting your timezone makes sure the dates and times the bot shows match your local time. The number format changes how large numbers are displayed (for example 1,000 versus 1.000).

Options:

  • Timezone - The timezone you want to set
  • Number format - The number formatting you want to use

Examples

/localization

/localization timezone:Europe/Amsterdam


.shortcuts (.sc) ⭐

Lets you set custom text command shortcuts. Your input is converted to the output you set, and any extra parameters you add are preserved. Shortcuts still use the normal text command prefix.

Use .shortcuts to view and manage your shortcuts.

Examples

.shortcuts

A shortcut yo set to fm textoneline — typing .yo then runs .fm textoneline.

A shortcut progress set to chart 5x5 2025 skip — typing .progress runs that chart.

⭐ Exclusive for .fmbot supporters

Shortcuts are stored in-memory across all bot instances to keep command handling fast, so availability is limited. Get .fmbot supporter here.