/friends
.fmbot is a social Discord bot that provides music statistics for you, your friends, and your fellow server members. Easily see who listens to your favorite artist in a server and make new friends. Or discover new artists within your favorite genres.
The bot connects to a Last.fm account to see your listening history. Over 800.000 users have already connected. To get started, create a Last.fm account and afterwards use /login in the bot.
/fm/fm to make it unique with /mode/WhoKnows in your server to see top listeners for artists and compete for crowns!/server commands/friendsEvery hour we feature a random user with something they've recently listened to. Everyone is able to see this using the /featured command, and anyone who recently used the bot gets a chance to become featured!
The bot will also change it's profile picture to the album cover of the feature. Want to be alerted when you get featured? Join our server and you'll get a ping.
"},{"location":"#links","title":"\ud83d\udd17Links:","text":".fmbot is trusted by over 400.000 servers, has over 800.000 registered users, and is used more than 500.000 times every day.
Even since the bot was created in 2017 we've been hard at work at providing the best and easiest to use music statistics.
Thank you to all our generous supporters. Support .fmbot too and get some nice perks in return. "},{"location":"botscrobbling/","title":"Music bot scrobbling","text":"Bot scrobbling is a new feature from .fmbot that allows you to automatically scrobble music from other Discord music bots to your Last.fm account.
The feature works fully automatic. Simply start listening to music using a supported bot and .fmbot will scrobble it for users in that voice channel.
The bot will only scrobble songs it can find on Last.fm. The scrobbling works best with Spotify songs.
"},{"location":"botscrobbling/#currently-supported-bots","title":"Currently supported bots:","text":"/loginUse this command to disable/enable bot scrobbling for your account or to check if you are ready for scrobbling.
Examples
/botscrobbling
Info
Please note that .fmbot is not affiliated with any of these music bots, and that .fmbot does not stream music or download music to Discord in any way.
"},{"location":"faq/","title":"Frequently Asked","text":""},{"location":"faq/#how-do-i-get-started","title":"How do I get started?","text":"This bot uses your music history for various commands. For this we use a website called Last.fm. This site allows you to track your music history from various platforms.
To get started you need to create a Last.fm account. After you've setup your account there you can connect your account to our bot by using /login within Discord.
While we require a Last.fm account the bot is not affiliated with Last.fm.
"},{"location":"faq/#commands-are-showing-the-wrong-songs-its-not-showing-what-i-listen-to-on-spotify","title":"Commands are showing the wrong songs / it's not showing what I listen to on Spotify","text":"We get what you're playing directly from your Last.fm profile, so please check there first to see what is showing on your profile.
Last.fm often has issues with their Spotify connection. For most people it helps to reconnect Spotify in their Last.fm application settings.
Last.fm also has an official guide on how to fix this.
.fmbot is not affiliated with Last.fm or Spotify, so we can't fix this for you. Please don't join our support server to complain about this issue.
"},{"location":"faq/#the-playcounts-in-the-bot-dont-match-lastfm","title":"The playcounts in the bot don't match Last.fm!","text":"Because we rely heavily on caching your playcounts to keep our commands fast it can sometimes happen that you don't get updated properly.
In this case, try to use .update full. This completely re-builds the stored playcounts the bot has for you.
Check out the importing page for more info.
Using imports requires an active supporter subscription.
"},{"location":"faq/#can-i-use-the-bot-in-dms-or-group-chats","title":"Can I use the bot in DM's or group chats?","text":"Yes! Just add fmbot as a user app onto your Discord account.
This way you'll be able to use slash commands from the bot in DM's, group chats and servers without .fmbot.
Click here to add the bot to your Discord account
"},{"location":"faq/#who-picks-what-is-featured","title":"Who picks what is featured?","text":"The bot randomly picks any user that has used .fmbot in the last day.
For more information, check out Featured
"},{"location":"faq/#how-do-i-remove-someone-from-whoknows","title":"How do I remove someone from WhoKnows?","text":"Please check the server WhoKnows settings.
"},{"location":"faq/#im-not-visible-in-global-whoknows","title":"I'm not visible in Global WhoKnows","text":"We sometimes remove or filter users from Global WhoKnows for various reasons, like sleep scrobbling, manipulating scrobbles or other reasons. If you're not showing on the global charts this could be the case.
You can use the .privacy command to check your status. Set your privacy to global and it will be visible, along with all info required. If youre're removed, please fully read this as it contains all the information you need.
Users get filtered automatically for 3 months from Global WhoKnows when:
We are not affiliated with Last.fm. This bot only uses their API to show you and your friends their statistics.
If you have issues with Last.fm, we'd suggest you check out their support forums or their Discord server.
"},{"location":"faq/#the-bot-is-offline","title":"The bot is offline","text":"It could be that it just happens to be updating. If it stays down, please join the support server and ping one of the developers.
"},{"location":"faq/#what-is-the-difference-between-the-normal-bot-and-the-develop-bot","title":"What is the difference between the normal bot and the develop bot?","text":"The develop bot is used to test new fixes and functionality before they go to the normal bot. This is usually announced in #beta-updates on our server.
This bot can have more downtime and bugs than the normal bot, so that is something to keep in mind. The bots currently share the same database, so switching is easy.
Note that if either bot leaves your server all your server data and settings will be cleared.
"},{"location":"faq/#i-like-this-bot","title":"I like this bot","text":"Cool, great to hear.
"},{"location":"faq/#i-dont-like-this-bot","title":"I don't like this bot","text":":( Please let us know why in the support server. We're open to all feedback and happy to help.
"},{"location":"faq/#is-there-any-way-to-support-the-bot","title":"Is there any way to support the bot?","text":"To support us financially, check out .fmbot supporter. You help us with the hosting and development of the bot while getting some nice perks in return.
If you are familiar with C# / .NET you can also help us out and pick up one of the open issues. Please check out our contributing guidelines first.
"},{"location":"faq/#why-does-this-bot-exist","title":"Why does this bot exist?","text":"This bot was made by BitL back in September 2017 and was inspired by UB3R Bot. Back then the bot just had .fm, the charts, featuring and .fmyoutube.
Frikandel joined in when he had the idea of .friends, but was too lazy to make his own bot. Together they moved the bot from text files to an actual database and made various other improvements.
Since 2019 Frikandel has been the main maintainer and hoster of .fmbot, adding commands like .whoknows and other much-requested features. In March 2021 Frikandel took over all parts of the bot.
Join our server here and ask in the #help channel.
Note that since .fmbot and Last.fm are two seperate things. .fmbot is the Discord bot, Last.fm is the website.
Need help with Last.fm? Check out their support forums or their Discord server.
"},{"location":"importing/","title":"Importing your music history","text":"The bot uses Last.fm by default for all your music data. We now also offer a way to import your listening history from Spotify and Apple Music and combine that together with your scrobbles.
The bot will adjust your Last.fm stats on the fly and dynamically add your imports on top.
This feature is only available for .fmbot supporters. Dont have supporter yet? Get it here.
"},{"location":"importing/#import-manage","title":"/import manage","text":"Allows you to manage your imports and pick the source for your playcounts.
You can pick between the following modes:
To delete your imports from .fmbot, switch to the Last.fm option and use the provided button.
Examples
/import manage
Allows you to import your Spotify streaming history in the bot.
Shows the instructions on how to get started if you attach no files. These instructions are also listed below.
This command only supports the 'Extended Streaming History' package. You can either upload the my_spotify_data.zip to import everything at once or upload each .json file separately.
Examples
/import Spotify
Using Discord on your phone?
Discord mobile currently has a bug where it might return Not a valid value. Please try importing your files through Discord desktop. We've reported this bug, sorry for the inconvenience.
/import Spotify slash command and add the .zip file as an attachment through the options.json file separatelyAllows you to import your Apple Music streaming history in the bot.
Shows the instructions on how to get started if you attach no files. These instructions are also listed below.
Examples
/import applemusic
/import applemusic slash command and add the .zip file as an attachment through the optionApple Music Play Activity.csv file separatelyImporting helps your music history be as complete as possible. Most people have been using streaming services like Spotify before they signed up for Last.fm, which means they don't have their full history.
Importing helps you combine your full history together with your current Last.fm data for the best .fmbot experience.
You get to keep your original listening timestamps added together with how long you listened to each track for more accurate listening time stats.
"},{"location":"importing/#the-import-command-keeps-saying-my-files-are-invalid","title":"The import command keeps saying my files are invalid.","text":"For Spotify we only support files from the 'Extended streaming history' package. You can try uploading the my_spotify_data.zip or attach each .json file separately.
Still having issues? Please open a thread on our server.
"},{"location":"importing/#its-adding-less-plays-to-my-fmbot-account-then-expected","title":"It's adding less plays to my .fmbot account then expected","text":"Try switching modes with the /import manage command. This changes how your imports are combined with your Last.fm scrobbles.
If you want to dive deeper, use the .importdebug command. You can also filter this command to a specific artist.
Spotify sends their files out in waves. For the extended streaming history package they usually do this once every 3 weeks.
Apple Music sends your file within a week.
"},{"location":"importing/#my-apple-music-imports-are-too-big-for-discord-and-i-dont-have-nitro","title":"My Apple Music imports are too big for Discord, and I don't have Nitro","text":"Try putting the Apple Music Play Activity.csv file in a .zip and using that.
If it does't work or it's not possible, you can also try in our support server which is boosted and has a higher file size limit for everyone.
"},{"location":"importing/#does-importing-in-fmbot-add-scrobbles-to-my-lastfm","title":"Does importing in .fmbot add scrobbles to my Last.fm?","text":"No, imported data only shows in the bot. No scrobbles are added to your Last.fm.
"},{"location":"importing/#what-happens-if-i-cancel-my-supporter-subscription","title":"What happens if I cancel my supporter subscription?","text":"Importing in .fmbot is a service that adjusts your Last.fm stats on the fly and adds your imported plays on top. If your supporter subscription expires, this service is no longer available and the bot will only use your Last.fm stats.
Your imported plays are however saved and will be available again if you resubscribe in the future.
"},{"location":"importing/#are-platforms-other-then-spotify-and-apple-music-also-supported","title":"Are platforms other then Spotify and Apple Music also supported?","text":"At the moment we only support Spotify and Apple Music.
Want a different platform to be supported? Open a help thread in our server. It helps if you have a data export ready for the developers, so that way they can test a possible integration.
Each platform should have some way for you to request your listening data. This is legally required in Europe, California and various other places around the world.
"},{"location":"importing/#can-i-change-or-delete-my-imports","title":"Can I change or delete my imports?","text":"See the /import manage command.
"},{"location":"importing/#what-data-from-my-imports-do-you-store","title":"What data from my imports do you store?","text":"We only store the following information:
Warning
Imports contain personal data like your IP address and username. Never post your import files publicly.
"},{"location":"privacy/","title":"Privacy","text":"What data .fmbot collects, how we use it and how you can manage it.
Last update: 2023-10-12
Changelog: Update command log storage policy
"},{"location":"privacy/#what-does-your-application-do","title":"What does your application do?","text":".fmbot is an open-source Last.fm Discord bot. Last.fm is a service that tracks what people listen to.
In our bot you can do various things to analyze your and your friends music taste, like see your recent plays or see who in a server listens to a certain artist.
To use the bot, you have to log in with a Last.fm account. After that you can optionally also login with a Discogs account.
"},{"location":"privacy/#what-data-do-you-store","title":"What data do you store?","text":"When someone logins to the bot, we store the following Discord data:
We store the following Last.fm data for every user:
If a user logs in with Discogs, we store the following data:
When the bot joins a server, the following data from that server is stored:
When specific settings for a server channel are set, the following data from that channel is stored:
When someone uses a command, the command log stores this:
If someone imports their Spotify history, we store the following data of their import files:
If a server has Premium Server, the following data will be stored for every logged-in user in the server:
No data is stored from users that are not logged into the bot.
'Logged in' means that a user has connected their Last.fm account to .fmbot with the 'login' command.
"},{"location":"privacy/#music-bot-scrobbling","title":"Music bot scrobbling","text":"If you have logged into the bot the bot will scrobble (store) songs music bots play to your Last.fm profile by default. You can opt-out of this feature by using the /botscrobbling command.
For this feature the bot tries to fetch the artist and track name from messages music bots send in your server. If a song is successfully found, it will be send to Last.fm. No message content is stored or processed otherwise.
"},{"location":"privacy/#for-what-purpose-do-you-store-it","title":"For what purpose do you store it?","text":"To identify who is calling the command and get the appropriate parameters to customize their command.
Music data and server data is used for commands that provide server-wide leaderboards and statistics.
This data is stored for caching purposes and to ensure our commands are performant. It is not possible to fetch data like playcounts for thousands of users real-time.
Command logs are used for statistics, debugging and helping people with bug reports.
"},{"location":"privacy/#for-how-long-do-you-store-it","title":"For how long do you store it?","text":"Settings data and command logs: Forever, or until deleted.
Server data: Forever, or until the bot is kicked from the server.
"},{"location":"privacy/#what-is-the-process-for-users-to-request-deletion-of-their-data","title":"What is the process for users to request deletion of their data?","text":"For user data we have a command (/remove).
For server data people can remove the bot and all the data related to that server will be deleted.
Users can also request deletion of their data in our support server.
"},{"location":"privacy/#what-systems-and-infrastructure-do-you-use","title":"What systems and infrastructure do you use?","text":".fmbot is currently hosted on a Hetzner VPS in Germany.
"},{"location":"privacy/#how-can-users-contact-you-with-security-issues","title":"How can users contact you with security issues?","text":"Through our server and DMs, or through Github issues. We are visibly identified as developers on the server.
"},{"location":"privacy/#does-your-app-utilize-other-third-party-auth-services-or-connections","title":"Does your app utilize other third-party auth services or connections?","text":"We provide auth services to the following services:
Personal .fmbot data will never be shared with any 3rd party services unless explicitly specified.
If you have any questions after reading all this feel free to contact us on our Discord or open an issue on our Github.
"},{"location":"setup/","title":"Development","text":"Setup guide for developers who wish to contribute. Selfhosting .fmbot is not supported.
"},{"location":"setup/#installing-the-database","title":"Installing the database","text":"config.json file later.Viewing the data
To view the data in the database, use pgadmin and click the fmbot database > schemas > public > tables.
"},{"location":"setup/#development_1","title":"Development","text":"config.json that's located in the bin folder. You will have to enter your own configuration values there.frikandel on Discord, or see our serverThe bot requires an internal API for some cache-heavy tasks.
This API is not publicly available, you should however be able to run and debug the bot without it for local development.
"},{"location":"setup/#getting-api-keys","title":"Getting API keys","text":""},{"location":"setup/#discord","title":"Discord","text":".fmbot is open-source and free to use. Optionally you can get supporter to help support the development of the bot and receive the following extra features and benefits.
You can get supporter either directly through Discord or through OpenCollective.
Discord
Monthly $3.99OpenCollective
Monthly $3.99 Yearly $29.99 Lifetime $49.99 Free Supporter Help us pay for hosting, development and other costs \u274c \u2705 Import and use your full Spotify history \u274c \u2705 New Import and use your full Apple Music history \u274c \u2705 Added friends limit 12 18 Personal automatic emoji reactions with.userreactions \u274c \u2705 Custom fm footer options 4 9 Get a better GPT-4 powered .judge command with higher limits and the ability to use the command on others \u274c \u2705 View when you discovered artists with the .discoveries command \u274c \u2705 New Play unlimited jumble games \u274c \u2705 Discovery dates in artist, album and track \u274c \u2705 Years and listening time overview in profile \u274c \u2705 Artist Discoveries and months in year \u274c \u2705 Lifetime history in recent and overview \u274c \u2705 Higher chance of getting featured on Supporter Sunday \u274c \u2705 Supporter badge \u2b50 \u274c \u2705 Chance to sponsor bot-wide charts \u274c \u2705 Your name in the supporters command \u274c \u2705 Exclusive role and channel on our Discord with sneak peeks of new features \u274c \u2705 Cached scrobble history Up to 1.5y Lifetime Cached artists Top 4000 Unlimited Cached albums Top 5000 Unlimited Cached tracks Top 6000 Unlimited Cached Discogs collection Last 100 Unlimited Thank you to all our generous supporters. "},{"location":"supporter/#frequently-asked","title":"Frequently asked","text":""},{"location":"supporter/#why-a-supporter-program","title":"Why a supporter program? In order to help us pay for hosting, fund development and deal with other expenses we've added a way for people to donate. In return for your support you get some cool exclusive perks.
We're dedicated to making sure the bot remains free and independent. That's why most supporter features are simply features that are nice but would be difficult to roll out to everyone. For example some of the extra statistics require us to store your full listening history, which would be difficult to do for all our users.
By getting supporter you help us to be able to spend more time working on new features and fixes, which in return improves the user experience for everyone.
","text":""},{"location":"supporter/#how-do-i-activate-my-subscription","title":"How do I activate my subscription?If you purchase through Discord it should get automatically activated within a minute.
If you have purchased through OpenCollective it needs to be added manually. Join our Discord and create a thread in #help. A staff member will apply it to your account as soon as possible.
","text":""},{"location":"supporter/#what-is-opencollective","title":"What is OpenCollective?OpenCollective is like Patreon, except for open source projects. It's also more transparent and easier when working with multiple people.
They manage our funds and allow us to focus on development while they handle the financial side of things.
OpenCollective relies on Stripe to handle their payments, which is one of the worlds biggest payment providers. You can read more about their security here.
","text":""},{"location":"supporter/#can-i-cancel-or-change-my-subscription","title":"Can I cancel or change my subscription?If you have purchased through Discord, you can go to settings and then 'Subscriptions'.
If you have puchased through OpenCollective, you can cancel a recurring contribution at any time. To do so, go to OpenCollective and sign in. After signing in go to 'Manage Contributions' where you can change your subscription.
","text":""},{"location":"supporter/#what-happens-if-i-cancel-my-subscription-and-have-imported-my-plays","title":"What happens if I cancel my subscription and have imported my plays?Importing in .fmbot is a service that adjusts your Last.fm stats on the fly and adds your imported plays on top. If your supporter subscription expires, this service is no longer available and the bot will only use your Last.fm stats.
Your imported plays are however saved and will be available again if you resubscribe in the future.
","text":""},{"location":"supporter/#does-being-an-fmbot-supporter-give-me-lastfm-pro-or-the-other-way-around","title":"Does being an .fmbot supporter give me Last.fm Pro? Or the other way around?No, .fmbot is not affiliated with Last.fm.
","text":""},{"location":"supporter/#i-have-a-question-that-isnt-listed-here","title":"I have a question that isn't listed herePlease join our server and make a thread in the #help channel. A staff member will try to help you as soon as possible.
","text":""},{"location":"terms/","title":"Terms of Use","text":"Last updated: October 12, 2023
"},{"location":"terms/#agreement-to-terms","title":"Agreement to Terms","text":"These Terms of Use constitute a legally binding agreement made between you, whether personally or on behalf of an entity (\u201cyou\u201d) and .fmbot (\".fmbot\" \u201cfmbot\u201d, \u201cwe\u201d, \u201cus\u201d, or \u201cour\u201d), concerning your access to and use of .fmbot as well as any other media form, website, media channel, mobile website or mobile application related, linked, or otherwise connected thereto (collectively, the \u201cBot\u201d). You agree that by accessing the Bot, you have read, understood, and agree to be bound by all of these Terms of Use. IF YOU DO NOT AGREE WITH ALL OF THESE TERMS OF USE, THEN YOU ARE EXPRESSLY PROHIBITED FROM USING THE BOT AND YOU MUST DISCONTINUE USE IMMEDIATELY. Supplemental terms and conditions or documents that may be posted on the website from time to time are hereby expressly incorporated herein by reference. We reserve the right, in our sole discretion, to make changes or modifications to these Terms of Use from time to time. We will alert you about any changes by updating the \u201cLast updated\u201d date of these Terms of Use, and you waive any right to receive specific notice of each such change. Please ensure that you check the applicable Terms every time you use our Bot so that you understand which Terms apply. You will be subject to, and will be deemed to have been made aware of and to have accepted, the changes in any revised Terms of Use by your continued use of the Bot after the date such revised Terms of Use are posted. The information provided on the Bot is not intended for distribution to or use by any person or entity in any jurisdiction or country where such distribution or use would be contrary to law or regulation or which would subject us to any registration requirement within such jurisdiction or country. Accordingly, those persons who choose to access the Bot from other locations do so on their own initiative and are solely responsible for compliance with local laws, if and to the extent local laws are applicable. The Bot is not tailored to comply with industry-specific regulations (Health Insurance Portability and Accountability Act (HIPAA), Federal Information Security Management Act (FISMA), etc.), so if your interactions would be subjected to such laws, you may not use this Bot. You may not use the Bot in a way that would violate the Gramm-Leach-Bliley Act (GLBA). The Bot is intended for users who are at least 13 years of age. All users who are minors in the jurisdiction in which they reside (generally under the age of 18) must have the permission of, and be directly supervised by, their parent or guardian to use the Bot. If you are a minor, you must have your parent or guardian read and agree to these Terms of Use prior to you using the Bot.
"},{"location":"terms/#user-representations","title":"User Representations","text":"By using the Bot, you represent and warrant that: (1) you have the legal capacity and you agree to comply with these Terms of Use; (2) you are not under the age of 13; (3) you are not a minor in the jurisdiction in which you reside, or if a minor, you have received parental permission to use the Bot; (4) you will not access the Discord Bot through automated or non-human means, whether through a bot, script or otherwise; (5) you will not use the Bot for any illegal or unauthorized purpose; and (6) your use of the Bot will not violate any applicable law or regulation.
"},{"location":"terms/#fees-and-payment","title":"Fees and Payment","text":"We use OpenCollective and Discord for payments.
When you use Discord for any purchases, you must agree to their Paid Services Terms:
https://support.discord.com/hc/en-us/articles/4410339366295
If you have payment issues, you can contact them here:
https://dis.gd/billing
When you use OpenCollective, you must agree to their Terms of Service and Privacy Policy:
https://opencollective.com/tos
https://opencollective.com/privacypolicy
If you have payment issues with OpenCollective, try contacting them. fmbot has limited access to help you resolve issues.
"},{"location":"terms/#prohibited-activities","title":"Prohibited Activities","text":"You may not access or use the Bot for any purpose other than that for which we make the Bot available. The Bot may not be used in connection with any commercial endeavors except those that are specifically endorsed or approved by us.
As a user of the Bot, you agree not to:
You and the Bot agree that we may access, store, process, and use any information and personal data that you provide following the terms of the Privacy Policy and your choices (including settings). By submitting suggestions or other feedback regarding the Bot, you agree that we can use and share such feedback for any purpose without compensation to you. We do not assert any ownership over your Contributions. You retain full ownership of all of your Contributions and any intellectual property rights or other proprietary rights associated with your Contributions. We are not liable for any statements or representations in your Contributions provided by you in any area on the Bot. You are solely responsible for your Contributions to the Bot and you expressly agree to exonerate us from any and all responsibility and to refrain from any legal action against us regarding your Contributions.
"},{"location":"terms/#submissions","title":"Submissions","text":"You acknowledge and agree that any questions, comments, suggestions, ideas, feedback, or other information regarding the Bot (\"Submissions\") provided by you to us are non-confidential and shall become our sole property. We shall own exclusive rights, including all intellectual property rights, and shall be entitled to the unrestricted use and dissemination of these Submissions for any lawful purpose, commercial or otherwise, without compensation to you. You hereby waive all moral rights to any such Submissions, and you hereby warrant that any such Submissions are original with you or that you have the right to submit such Submissions. You agree there shall be no recourse against us for any alleged or actual infringement or misappropriation of any proprietary right in your Submissions.
"},{"location":"terms/#third-party-websites-and-content","title":"Third-Party Websites and Content","text":"The Bot may contain (or you may be sent via the Bot) links to other websites (\"Third-Party Websites\") as well as articles, photographs, text, graphics, pictures, designs, music, sound, video, information, applications, software, and other content or items belonging to or originating from third parties (\"Third-Party Content\"). Such Third-Party Websites and Third-Party Content are not investigated, monitored, or checked for accuracy, appropriateness, or completeness by us, and we are not responsible for any Third-Party Websites accessed through the Bot or any Third-Party Content posted on, available through, or installed from the Bot, including the content, accuracy, offensiveness, opinions, reliability, privacy practices, or other policies of or contained in the Third-Party Websites or the Third-Party Content. Inclusion of, linking to, or permitting the use or installation of any Third-Party Websites or any Third-Party Content does not imply approval or endorsement thereof by us. If you decide to leave the Bot and access the Third-Party Websites or to use or install any Third-Party Content, you do so at your own risk, and you should be aware these Terms of Use no longer govern. You should review the applicable terms and policies, including privacy and data gathering practices, of any website to which you navigate from the Bot or relating to any applications you use or install from the Bot. Any purchases you make through Third-Party Websites will be through other websites and from other companies, and we take no responsibility whatsoever in relation to such purchases which are exclusively between you and the applicable third party. You agree and acknowledge that we do not endorse the products or services offered on Third-Party Websites and you shall hold us harmless from any harm caused by your purchase of such products or services. Additionally, you shall hold us harmless from any losses sustained by you or harm caused to you relating to or resulting in any way from any Third-Party Content or any contact with Third-Party Websites.
"},{"location":"terms/#bot-management","title":"Bot Management","text":"We reserve the right, but not the obligation, to: (1) monitor the Bot for violations of these Terms of Use; (2) take appropriate action against anyone who, in our sole discretion, violates the law or these Terms of Use, including without limitation, reporting such user to law enforcement authorities; (3) in our sole discretion and without limitation, refuse, restrict access to, limit the availability of, or disable (to the extent technologically feasible) any of your Contributions or any portion thereof; (4) in our sole discretion and without limitation, notice, or liability, to remove from the Bot or otherwise disable all files and content that are excessive in size or are in any way burdensome to our systems; and (5) otherwise manage the Bot in a manner designed to protect our rights and property and to facilitate the proper functioning of the Bot.
"},{"location":"terms/#privacy-policy","title":"Privacy Policy","text":"We care about data privacy and security. Please review our Privacy Policy: https://fmbot.xyz/privacy. By using the Bot, you agree to be bound by our Privacy Policy, which is incorporated into these Terms of Use. Please be advised the Bot is hosted in Finland. If you access the Bot from any other region of the world with laws or other requirements governing personal data collection, use, or disclosure that differ from applicable laws in Finland, then through your continued use of the Bot, you are transferring your data to Finland, and you agree to have your data transferred to and processed in Finland. Further, we do not knowingly accept, request, or solicit information from children or knowingly market to children. Therefore, in accordance with the U.S. Children\u2019s Online Privacy Protection Act, if we receive actual knowledge that anyone under the age of 13 has provided personal information to us without the requisite and verifiable parental consent, we will delete that information from the Bot as quickly as is reasonably practical.
"},{"location":"terms/#term-and-termination","title":"Term and Termination","text":"These Terms of Use shall remain in full force and effect while you use the Bot. WITHOUT LIMITING ANY OTHER PROVISION OF THESE TERMS OF USE, WE RESERVE THE RIGHT TO, IN OUR SOLE DISCRETION AND WITHOUT NOTICE OR LIABILITY, DENY ACCESS TO AND USE OF THE BOT (INCLUDING BLOCKING CERTAIN IP ADDRESSES), TO ANY PERSON FOR ANY REASON OR FOR NO REASON, INCLUDING WITHOUT LIMITATION FOR BREACH OF ANY REPRESENTATION, WARRANTY, OR COVENANT CONTAINED IN THESE TERMS OF USE OR OF ANY APPLICABLE LAW OR REGULATION. WE MAY TERMINATE YOUR USE OR PARTICIPATION IN THE BOT OR DELETE ANY CONTENT OR INFORMATION THAT YOU POSTED AT ANY TIME, WITHOUT WARNING, IN OUR SOLE DISCRETION. If we terminate or suspend your access for any reason, you are prohibited from using a new account under your name, a fake or borrowed name, or the name of any third party, even if you may be acting on behalf of the third party. In addition to terminating or suspending your account, we reserve the right to take appropriate legal action, including without limitation pursuing civil, criminal, and injunctive redress.
"},{"location":"terms/#modifications-and-interruptions","title":"Modifications and Interruptions","text":"We reserve the right to change, modify, or remove the contents of the bot at any time or for any reason at our sole discretion without notice. While we will make a best effort to inform our users we have no obligation to update any information on our bot. We also reserve the right to modify or discontinue all or part of the bot without notice at any time. We will not be liable to you or any third party for any modification, price change, suspension, or discontinuance of the bot. We cannot guarantee the bot will be available at all times. We may experience hardware, software, or other problems or need to perform maintenance related to the bot, resulting in interruptions, delays, or errors. We reserve the right to change, revise, update, suspend, discontinue, or otherwise modify the bot at any time or for any reason without notice to you. You agree that we have no liability whatsoever for any loss, damage, or inconvenience caused by your inability to access or use the bot during any downtime or discontinuance of the bot. Nothing in these Terms of Use will be construed to obligate us to maintain and support the bot or to supply any corrections, updates, or releases in connection therewith.
"},{"location":"terms/#governing-law","title":"Governing Law","text":"These conditions are governed by and interpreted following the laws of the Netherlands, and the use of the United Nations Convention of Contracts for the International Sale of Goods is expressly excluded. If your habitual residence is in the EU, and you are a consumer, you additionally possess the protection provided to you by obligatory provisions of the law of your country of residence. .fmbot and yourself both agree to submit to the non-exclusive jurisdiction of the courts of The Netherlands, which means that you may make a claim to defend your consumer protection rights in regards to these Conditions of Use in the Netherlands, or in the EU country in which you reside.
"},{"location":"terms/#corrections","title":"Corrections","text":"There may be information on the bot that contains typographical errors, inaccuracies, or omissions, including descriptions, pricing, availability, and various other information. We reserve the right to correct any errors, inaccuracies, or omissions and to change or update the information on the bot at any time, without prior notice.
"},{"location":"terms/#disclaimer","title":"Disclaimer","text":"THE BOT IS PROVIDED ON AN AS-IS AND AS-AVAILABLE BASIS. YOU AGREE THAT YOUR USE OF THE SITE AND OUR SERVICES WILL BE AT YOUR SOLE RISK. TO THE FULLEST EXTENT PERMITTED BY LAW, WE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, IN CONNECTION WITH THE BOT AND YOUR USE THEREOF, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. WE MAKE NO WARRANTIES OR REPRESENTATIONS ABOUT THE ACCURACY OR COMPLETENESS OF THE BOT\u2019S CONTENT OR THE CONTENT OF ANY WEBSITES LINKED TO THE BOT AND WE WILL ASSUME NO LIABILITY OR RESPONSIBILITY FOR ANY (1) ERRORS, MISTAKES, OR INACCURACIES OF CONTENT AND MATERIALS, (2) PERSONAL INJURY OR PROPERTY DAMAGE, OF ANY NATURE WHATSOEVER, RESULTING FROM YOUR ACCESS TO AND USE OF THE BOT, (3) ANY UNAUTHORIZED ACCESS TO OR USE OF OUR SECURE SERVERS AND/OR ANY AND ALL PERSONAL INFORMATION AND/OR FINANCIAL INFORMATION STORED THEREIN, (4) ANY INTERRUPTION OR CESSATION OF TRANSMISSION TO OR FROM THE WEBSITE, (5) ANY BUGS, VIRUSES, TROJAN HORSES, OR THE LIKE WHICH MAY BE TRANSMITTED TO OR THROUGH THE BOT BY ANY THIRD PARTY, AND/OR (6) ANY ERRORS OR OMISSIONS IN ANY CONTENT AND MATERIALS OR FOR ANY LOSS OR DAMAGE OF ANY KIND INCURRED AS A RESULT OF THE USE OF ANY CONTENT POSTED, TRANSMITTED, OR OTHERWISE MADE AVAILABLE VIA THE BOT. WE DO NOT WARRANT, ENDORSE, GUARANTEE, OR ASSUME RESPONSIBILITY FOR ANY PRODUCT OR SERVICE ADVERTISED OR OFFERED BY A THIRD PARTY THROUGH THE BOT, ANY HYPERLINKED WEBSITE, OR ANY WEBSITE OR MOBILE APPLICATION FEATURED IN ANY BANNER OR OTHER ADVERTISING, AND WE WILL NOT BE A PARTY TO OR IN ANY WAY BE RESPONSIBLE FOR MONITORING ANY TRANSACTION BETWEEN YOU AND ANY THIRD-PARTY PROVIDERS OF PRODUCTS OR SERVICES. AS WITH THE PURCHASE OF A PRODUCT OR SERVICE THROUGH ANY MEDIUM OR IN ANY ENVIRONMENT, YOU SHOULD USE YOUR BEST JUDGMENT AND EXERCISE CAUTION WHERE APPROPRIATE.
"},{"location":"terms/#limitations-of-liability","title":"Limitations of Liability","text":"IN NO EVENT WILL WE OR OUR DIRECTORS, EMPLOYEES, OR AGENTS BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, SPECIAL, OR PUNITIVE DAMAGES, INCLUDING LOST PROFIT, LOST REVENUE, LOSS OF DATA, OR OTHER DAMAGES ARISING FROM YOUR USE OF THE BOT, EVEN IF WE HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. NOTWITHSTANDING ANYTHING TO THE CONTRARY CONTAINED HEREIN, OUR LIABILITY TO YOU FOR ANY CAUSE WHATSOEVER AND REGARDLESS OF THE FORM OF THE ACTION, WILL AT ALL TIMES BE LIMITED TO THE AMOUNT PAID, IF ANY, BY YOU TO US. CERTAIN US STATE LAWS AND INTERNATIONAL LAWS DO NOT ALLOW LIMITATIONS ON IMPLIED WARRANTIES OR THE EXCLUSION OR LIMITATION OF CERTAIN DAMAGES. IF THESE LAWS APPLY TO YOU, SOME OR ALL OF THE ABOVE DISCLAIMERS OR LIMITATIONS MAY NOT APPLY TO YOU, AND YOU MAY HAVE ADDITIONAL RIGHTS.
"},{"location":"terms/#indemnification","title":"Indemnification","text":"You agree to defend, indemnify, and hold us harmless, including our subsidiaries, affiliates, and all of our respective officers, agents, partners, and employees, from and against any loss, damage, liability, claim, or demand, including reasonable attorneys\u2019 fees and expenses, made by any third party due to or arising out of: (1) use of the Bot; (2) breach of these Terms of Use; (3) any breach of your representations and warranties set forth in these Terms of Use; (4) your violation of the rights of a third party, including but not limited to intellectual property rights; or (5) any overt harmful act toward any other user of the Bot with whom you connected via the Bot. Notwithstanding the foregoing, we reserve the right, at your expense, to assume the exclusive defense and control of any matter for which you are required to indemnify us, and you agree to cooperate, at your expense, with our defense of such claims. We will use reasonable efforts to notify you of any such claim, action, or proceeding which is subject to this indemnification upon becoming aware of it.
"},{"location":"terms/#user-data","title":"User Data","text":"We will maintain certain data that you transmit to the Bot for the purpose of managing the performance of the Bot, as well as data relating to your use of the Bot. Although we perform regular routine backups of data, you are solely responsible for all data that you transmit or that relates to any activity you have undertaken using the Bot. You agree that we shall have no liability to you for any loss or corruption of any such data, and you hereby waive any right of action against us arising from any such loss or corruption of such data.
"},{"location":"terms/#electric-communications-transactions-and-signatures","title":"Electric Communications, Transactions and Signatures","text":"Using the Bot, visiting the website, sending us emails, and completing online forms constitute electronic communications. You consent to receive electronic communications, and you agree that all agreements, notices, disclosures, and other communications we provide to you electronically, via email and on the Bot, satisfy any legal requirement that such communication be in writing. YOU HEREBY AGREE TO THE USE OF ELECTRONIC SIGNATURES, CONTRACTS, ORDERS, AND OTHER RECORDS, AND TO ELECTRONIC DELIVERY OF NOTICES, POLICIES, AND RECORDS OF TRANSACTIONS INITIATED OR COMPLETED BY US OR VIA THE BOT. You hereby waive any rights or requirements under any statutes, regulations, rules, ordinances, or other laws in any jurisdiction which require an original signature or delivery or retention of non-electronic records, or to payments or the granting of credits by any means other than electronic means.
"},{"location":"terms/#california-users-and-residents","title":"California Users and Residents","text":"If any complaint with us is not satisfactorily resolved, you can contact the Complaint Assistance Unit of the Division of Consumer Services of the California Department of Consumer Affairs in writing at 1625 North Market Blvd., Suite N 112, Sacramento, California 95834 or by telephone at (800) 952-5210 or (916) 445-1254.
"},{"location":"terms/#miscellaneous","title":"Miscellaneous","text":"These Terms of Use and any policies or operating rules posted by us on the website or in respect to the Bot constitute the entire agreement and understanding between you and us. Our failure to exercise or enforce any right or provision of these Terms of Use shall not operate as a waiver of such right or provision. These Terms of Use operate to the fullest extent permissible by law. We may assign any or all of our rights and obligations to others at any time. We shall not be responsible or liable for any loss, damage, delay, or failure to act caused by any cause beyond our reasonable control. If any provision or part of a provision of these Terms of Use is determined to be unlawful, void, or unenforceable, that provision or part of the provision is deemed severable from these Terms of Use and does not affect the validity and enforceability of any remaining provisions. There is no joint venture, partnership, employment or agency relationship created between you and us as a result of these Terms of Use or use of the Bot. You agree that these Terms of Use will not be construed against us by virtue of having drafted them. You hereby waive any and all defenses you may have based on the electronic form of these Terms of Use and the lack of signing by the parties hereto to execute these Terms of Use.
"},{"location":"terms/#contact-us","title":"Contact Us","text":"Discord: https://discord.gg/fmbot
"},{"location":"commands/","title":"Getting started","text":"To view a list of all available commands, use the sidebar. The basic commands to get started are listed below.
.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 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.
Have an issue with the bot you need help with? Please check the Frequently Asked section first.
"},{"location":"commands/#login","title":".login","text":"This command connects your Last.fm account to .fmbot.
After using this command the bot will DM you a link where you can allow access to your Last.fm account.
Not receiving a DM from .fmbot when using this command? Please check if you have DMs enabled in the servers privacy settings.
Examples
.login
/login (responds in-channel)
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.
Shows information about getting started with the bot.
Examples
.help
Shows you or someone else their user profile with some interesting statistics.
Options:
lfm:username)Examples
.profile
.stats
Want to see a yearly overview on your profile? Get .fmbot supporter here.
"},{"location":"commands/#settings","title":".settings","text":"Shows an overview of all your .fmbot settings.
Use the dropdown to pick what setting you want to change.
Examples
.settings
/settings (responds in-channel)
This command allows you to change how your .fm command looks.
Available modes:
You can also enable up to 4 custom options to show in your .fm footer.
Use the provided dropdowns to select and de-select which options you want.
Examples
.fmmode
/fmmode (responds in-channel)
Supporters can select up 9 options, and have access to some exclusive options like first artist listen. Get .fmbot supporter here.
"},{"location":"commands/#responsemode","title":".responsemode","text":"This command allows you to change how responses to the various whoknows and top lists commmand look.
Modes: embed or image
You can also override this preference on every invididual command. Simply add img or embed to the command.
Examples
.responsemode
Override examples
.whoknows the beatles image
.toptracks 2023 img
.globalwhoknows mac miller embed
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.
This setting is supporter only. Get .fmbot supporter here.
Examples
.userreactions :PagChomp: :PensiveBlob:
.userreactions \ud83d\ude00 \ud83d\ude2f \ud83e\udd75
.userreactions \ud83d\ude00 \ud83d\ude2f :PensiveBlob:
.userreactions
.ab)","text":"Gets information about current album or the one you're searching for.
Examples
.ab
.album
.album Ventura Anderson .Paak
Want this command to also show the date you discovered an album? Get .fmbot supporter here.
"},{"location":"commands/albums/#albumplays-abp","title":".albumplays (.abp)","text":"Shows you your playcount for current album or the one you're searching for.
Options:
lfm:username)Examples
.abp
.albumplays
.albumplays The Slow Rush
.c)","text":"Creates a chart of your top albums over a certain time period.
Options:
2x2, 3x5 all the way up to 10x10.r:2023)notitles - Don't display album titles. (nt)skipemptyalbums - Skips albums without images. (s or skip)lfm:username)Available time periods: weekly, monthly, quarterly, half, yearly or alltime (w, m, q, h, y or a)
Examples
.c
.chart
.chart 5x5
.chart 8x8 yearly
.chart 6x8 alltime notitles
.chart released:2022
.c 8x10 a nt s
.aoty)","text":"Generates a chart of albums released in a specific year.
It works the exact same as the chart command, except that you can directly input the release year for the filter.
Examples
.aoty 2023
.tab)","text":"Shows a list of you or your friends top albums over a certain time period.
Options:
r:2023)lfm:username)embed or imageTime periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.tab
.topalbums billboard
.tab a bb
.topalbums 2023 @user
.topalbums quarterly @slipper
.topalbums r:2022
.abt)","text":"Shows a list of tracks in an album that you have plays on.
Note that Last.fm or Spotify will sometimes not return the tracks within an album.
Options:
lfm:username)Examples
.abt
.albumtracks
.albumtracks the beatles yesterday
.co)","text":"Shows the cover for current album or the one you're searching for.
Examples
.co
.cover
.cover la priest inji
.cover featured
.wkab, .wa)","text":"Shows who in your server listened to current album or the one you're searching for.
Options:
embed or imageExamples
.wa
.whoknowsalbum
.whoknowsalbum The Beatles Abbey Road
.whoknowsalbum Metallica & Lou Reed | Lulu
.fwkab, .fwa)","text":"Shows who from your friends listened to current album or the one you're searching for.
Options:
embed or imageExamples
.fwa
.friendwhoknowsalbum
.friendwhoknowsalbum The Beatles Abbey Road
.friendwhoknowsalbum Metallica & Lou Reed | Lulu
.gwka, .gwa)","text":"Shows who in .fmbot listened to current album or the one you're searching for.
This searches through all registered .fmbot users. Note that some users with fake playcounts might be excluded.
Options:
embed or imageExamples
.gwa
.globalwhoknowsalbum
.globalwhoknowsalbum The Beatles Abbey Road
.globalwhoknowsalbum Metallica & Lou Reed | Lulu
Shows top albums for everyone in your server.
Options:
alltime, monthly or weeklylisteners or playsExamples
.sab
.serveralbums a p
.serveralbums alltime plays
.serveralbums listeners weekly
.a)","text":"Shows information about current artist or the one you're searching for.
Options:
random/rnd to view a random artist you've listened toExamples
.a
.artist
.a Gorillaz
.artist David Vunk
Want this command to also show the date you discovered an artist? Get .fmbot supporter here.
"},{"location":"commands/artists/#affinity-aff","title":".affinity (.aff)","text":"Shows users in the same server with similar music taste to you.
Uses your alltime top artists and recent top artists.
Options:
lfm:username)Examples
.aff
.affinity
.ap)","text":"Shows you your playcount for the artist you're currently listening to or searching for.
Options:
lfm:username)random/rnd to view a random artist you've listened toExamples
.ap
.artistplays
.artistplays Mall Grab
.ac)","text":"Creates a chart of your top artists over a certain time period.
Options:
2x2, 3x5 all the way up to 10x10.notitles - Don't display artist names. (nt)skip - Skips artists without images. (s)lfm:username)Available time periods: weekly, monthly, quarterly, half, yearly or alltime (w, m, q, h, y or a)
Examples
.ac
.artistchart
.artistchart 5x5
.artistchart 4x8 yearly
.artistchart 8x8 alltime notitles
.artistchart 8x8 alltime notitles skip
.ac 8x10 a nt s
.at)","text":"Shows you your all-time top tracks for current artist or the one you're searching for.
Options:
lfm:username)Examples
.at
.artisttracks
.artisttracks Crystal Castles
.aa)","text":"Shows you your all-time top albums for current artist or the one you're searching for.
Options:
lfm:username)Examples
.aa
.artistalbums
.artistalbums Frank Ocean
.ta)","text":"Shows a list of you or your friends top artists over a certain time period.
Options:
lfm:username)embed or imageTime periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.ta
.artists
.topartists billboard
.ta w bb
.topartists 2023 @user
.topartists alltime @drasil
.t)","text":"Compares your top artists, genres, countries and Discogs to those of someone else.
Options:
Time periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustModes:
t): Default. Works on all platforms, might not properly outline non-unicode characterse): Looks better, but is unreadable on mobile.Examples
.t frikandel_
.t @user
.taste bitldev
.taste @user monthly embed
.t @user m e
.wk, .w)","text":"Shows who in your server listened to current artist or the one you're searching for.
Options:
embed or imagerandom/rnd to view a random artist you've listened toExamples
.w
.wk
.w COMA
.whoknows
.whoknows Agar Agar img
.fwk, .fw)","text":"Shows who from your friends listened to current artist or the one you're searching for.
Options:
embed or imagerandom/rnd to view a random artist you've listened toExamples
.fw
.fwk
.fw COMA
.friendwhoknows
.friendwhoknows KAYTRANADA
.gwk, .gw)","text":"Shows who in .fmbot listened to current artist or the one you're searching for.
This searches through all registered .fmbot users. Note that some users with fake playcounts might be excluded.
Options:
embed or imagerandom/rnd to view a random artist you've listened toExamples
.gw
.gwk
.gw COMA
.globalwhoknows
.globalwhoknows Romy
Shows top artists for everyone in your server.
Options:
alltime, monthly or weeklylisteners or playsExamples
.sa
.serverartists a p
.serverartists alltime plays
.serverartists listeners weekly
.d)","text":"Shows a list of when you discovered artists, together with their alltime playcount.
Options:
lfm:username)Time periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.ta
.artists
.topartists billboard
.ta w bb
.topartists weekly @user
.topartists alltime @drasil
This command requires .fmbot to store your full listening history, which we only do for supporters. Get .fmbot supporter here.
"},{"location":"commands/countries/","title":"Country commands","text":"Countries are sourced from MusicBrainz.
To enter countries, you can either enter the full name or the 2 letter ISO code.
"},{"location":"commands/countries/#topcountriestc","title":".topcountries(.tc)","text":"Shows a list of you or your friends top countries over a certain time period.
Options:
lfm:username)embed or imageTime periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.tc
.topcountries billboard
.topcountries weekly @user
.tc alltime @Voaz bb
.topcountries monthly lfm:fm-bot
.from)","text":"Shows country information for your current artist or your top artists for the country you're searching for.
Examples
.from
.country
.country Netherlands
.country Mac DeMarco
A crown is an award that you get if you're the #1 listener for a certain artist in a server.
To get crowns you can use .whoknows.
Crown server settings are available here. Leaving a server resets all your crowns for that server.
"},{"location":"commands/crowns/#crowns-cws","title":".crowns (.cws)","text":"Shows your top crowns or crowns for a user you're searching for.
Options:
lfm:username)Examples
.cws
.crowns
.crowns @frikandel
.cw)","text":"Shows the current crown owner and crown history for the artist you're currently listening to or searching for.
Examples
.cw
.crown
.crown the beatles
.crown tame impala
.cwlb)","text":"Shows the users with the most crowns on your server.
Examples
.cwlb
.crownleaderboard
Looking for automatic crowns, crown settings and ways to moderate crowns on your server? That's available here in the server setting section.
"},{"location":"commands/discogs/","title":"Discogs commands","text":""},{"location":"commands/discogs/#discogs","title":".discogs","text":"Allows you to connect or manage the connection with your Discogs account.
The bot will send you a DM where you can configure this.
You can also show/hide the display of your collection value on your profile.
Examples
.discogs
Shows you or someone else their Discogs collection.
Allows for searching through artist or album title. One can also search by format type, include cassette, cd or vinyl in the command to enable.
This command updates your stored collection in .fmbot. Your collection can only be updated once per hour.
Some places where your collection can also be visible are the profile, artist, album as well as taste commands if both you and the other user have run .discogs.
Options:
lfm:username)Examples
.collection
.collection mall grab
.collection cd
Only the last 100 items you've added to Discogs can be viewed and stored.
Want to view your whole collection? Get .fmbot supporter here.
"},{"location":"commands/featured/","title":"Featured commands","text":""},{"location":"commands/featured/#featured","title":".featured","text":"Shows the user that is currently featured.
Anyone that is registered in fmbot can get featured, on one condition: They must have used .fmbot in the last day.
Want to be notified when you're featured? Join our server and you'll get a ping.
Possible featured modes:
If your top album doesn't have a picture, no worries. The bot will just grab the next album that has a picture. The album cover will also be used as the bot's profile picture.
Examples
.featured
Every first Sunday of each month is Supporter Sunday. On this day .fmbot picks featured from .fmbot supporters, as a thank you for supporting the bot. Get .fmbot supporter here.
"},{"location":"commands/featured/#featuredlog","title":".featuredlog","text":"Shows your or someone else their featured history.
Options:
lfm:username)Global, Server, Friends or UserExamples
.featuredlog
.featuredlog @user
.featuredlog server
.f)","text":"Shows the latest scrobble of your added friends in a list.
Examples
.friends
Adds one or multiple friends to your friends list.
Select other users by mention, Discord ID or Last.fm username
Examples
.addfriends frikandel_
.addfriends frikandel_ otherlastfmuser
.addfriends frikandel_ @discorduser
.addfriends 356268235697553409
Did you know there's also another way to add friends? Simply rightclick their profile > Apps > Add Friend
Want to be able to add more friends (up to 18)? Get .fmbot supporter here.
"},{"location":"commands/friends/#removefriends","title":".removefriends","text":"Removes one or multiple friends from your friends list.
Select other users by mention, Discord ID or Last.fm username
Examples
.removefriends frikandel_
.removefriends frikandel_ otherlastfmuser
.removefriends frikandel_ @discorduser
.removefriends 356268235697553409
Did you know there's also another way to add friends? Simply rightclick their profile > Apps > Remove Friend
Removes all your friends from your friends list.
Examples
.removeallfriends
.fwk, .fw)","text":"Shows who from your friends listened to an artist you're currently listening to or the one you're searching for.
Options:
Examples
.fw
.fwk
.fw MGMT
.friendwhoknows
.friendwhoknows Nia Archives
.fwkab, .fwa)","text":"Shows who from your friends listened to an album you're currently listening to or the one you're searching for.
Options:
Examples
.fwa
.friendwhoknowsalbum
.friendwhoknowsalbum The Beatles Help
.friendwhoknowsalbum Metallica & Lou Reed | Lulu
.fwkt, .fwt)","text":"Shows who from your friends listened to an track you're currently listening to or the one you're searching for.
Options:
Examples
.fwt
.friendwhoknowstrack
.friendwhoknowstrack Vansire Metamodernity
.friendwhoknowstrack Natasha Bedingfield | Unwritten
.j)","text":"Play the new Jumble game! Guess the artist out of your all-time top artists together with your friends.
Examples
.j
.jumble
Server staff and want to restrict jumble to specific channels? Use .togglecommand
Want to play unlimited jumbles every day? Get .fmbot supporter here.
"},{"location":"commands/games/#pixel-px","title":".pixel (.px)","text":"Play the new Pixel jumble game! Guess the album out of your all-time top albums together with your friends.
Examples
.px
.pixel
Server staff and want to restrict pixel jumble to specific channels? Use .togglecommand
Want to play unlimited pixel jumbles every day? Get .fmbot supporter here.
"},{"location":"commands/genius/","title":"Genius commands","text":""},{"location":"commands/genius/#genius-gen","title":".genius (.gen)","text":"Gets the Genius link for the song you're currently listening to, or the one you're searching for.
Examples
.gen
.genius
.gen Nas Never Die
.genius Mac Miller Good News
Genres are sourced from Spotify.
To view a list of all Spotify genres, you can use the website everynoise.com
"},{"location":"commands/genres/#topgenrestg","title":".topgenres(.tg)","text":"Shows a list of you or your friends top genres over a certain time period.
Options:
lfm:username)embed or imageTime periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.tg
.topgenres billboard
.topgenres weekly @user
.tg alltime @drasil bb
.topgenres 2023 lfm:fm-bot
.g)","text":"Shows genre information for your current artist or your top artists for the genre you're searching for.
Options:
lfm:username)Server or UserExamples
.g
.genre
.genre electro
.genre Mac DeMarco
.g lfm:fm-bot
.wg)","text":"Shows who in your server listened to a genre you're searching for.
Options:
Examples
.wg
.wkg
.wg hiphop
.whoknowsgenre techno
Shows top genres for everyone in your server.
Options:
alltime, monthly or weeklylisteners or playsExamples
.sg
.servergenres a p
.servergenres alltime plays
.servergenres listeners weekly
It's possible to remove .fmbot's response, even if you don't have permission to manage messages.
Mobile: Long press message > Apps > Delete response
Desktop: Right-click message > Apps > Delete response
"},{"location":"commands/misc/#reply-context","title":"Reply context","text":"You can reply to any fmbot command or response that contains an artist, album or track to directly use that as context for your new command.
Example below:
"},{"location":"commands/misc/#judge","title":".judge","text":"Judges your music taste using AI. You can pick between either a compliment or a roast.
Free users can use this command 3 times a day, supporters up to 15.
Supporters also get access to higher quality GPT-4 powered compliments and roasts.
Options:
lfm:username)Examples
.judge
The usage limits for this command might be adjusted depending on popularity and cost.
"},{"location":"commands/misc/#rateyourmusic","title":".rateyourmusic","text":"Enables/disabled an option that changes all album links to link to RateYourMusic.
Examples
.rym
Shows all the information and links related to the bot.
Examples
.info
Gets the bot status information.
Examples
.status
Deletes all your user information, including all your friends and other settings.
Examples
.remove
Shows your last 1 or 2 scrobbles, either in embed or text format.
You can set how your .fm embed looks with the .mode command.
Options:
lfm:username)Examples
.fm
.fm @user
.fm lfm:lastfmusername
.fm this is a nice song
Tip: You can click the embed title to go to the users Last.fm profile.
If you want .fmbot to add reactions to this command, please see .serverreactions.
.r)","text":"Shows your latest plays.
Options:
lfm:username)Examples
.r
.recent
For supporters this command expands to your full listening history. Supporters can also filter to specific artists. Get .fmbot supporter here.
"},{"location":"commands/plays/#streak-str","title":".streak (.str)","text":"Shows your track, album or artist streak.
Options:
lfm:username)Examples
.str
.streak
.o)","text":"Shows you an overview of your top track, album and artist for the last few days.
Options:
lfm:username)Examples
.o
.overview
.overview 8
.pc)","text":"Shows you an estimate of when you will reach a certain amount of plays.
Options:
lfm:username)Time periods: weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)
Examples
.pc
.pace
.pace a 73k
.pace 50000 quarterly
.ms)","text":"Shows you your latest scrobble milestones.
Options:
lfm:username)random/rnd to view a random milestoneExamples
.ms
.ms 30k
.milestone
.milestone 20k
.milestone 1337 @frikandel
.milestone rnd
.wrapped)","text":"Shows you an overview of you or someone else their year.
Supporters get an extra page with Artist Discoveries and a monthly overview.
Options:
lfm:username)Examples
.year
.year 2024
.wrapped @frikandel
.sp)","text":"Gets the Spotify link for the song you're currently listening to, or the one you're searching for.
Examples
.sp
.spotify
.sp C418 Sweden
.spotify Delta Sleep Camp Adventure
.spab)","text":"Gets the Spotify link for the album you're currently listening to, or the one you're searching for.
Examples
.spab
.spotifyalbum
.spab De Jeugd De Lachende Derde
.spotifyalbum Alexander Robotnick April
.spa)","text":"Gets the Spotify link for the artist you're currently listening to, or the one you're searching for.
Examples
.spa
.spotifyartist
.spa Green Day
.spotifyartist Acid Pauli
.tr)","text":"Gets information about the track you're currently listening to or searching for.
Examples
.tr
.track
.track Kaytranada You're The One
Want this command to also show the date you discovered a track? Get .fmbot supporter here.
"},{"location":"commands/tracks/#trackplays-tp","title":".trackplays (.tp)","text":"Shows you your playcount for current track or the one you're searching for.
Options:
lfm:username)Examples
.tp
.trackplays
.trackplays Infected Mushroom Can't Stop
.td)","text":"Shows metadata for current track or the one you're searching for.
Examples
.td
.trackdetails
.trackdetails Underworld Born Slippy
.r)","text":"Shows your latest plays.
Options:
lfm:username)Examples
.r
.recent
For supporters this command expands to your full listening history. Get .fmbot supporter here.
"},{"location":"commands/tracks/#toptracks-tt","title":".toptracks (.tt)","text":"Shows a list of you or your friends top tracks over a certain time period.
Options:
lfm:username)embed or imageTime periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.tt
.toptracks billboard
.tt y bb
.toptracks 2023 @user
.toptracks @john alltime
.rcpt)","text":"Shows your track receipt. Based on Receiptify.
Options:
lfm:username)Time periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.rcpt
.receipt
.receipt march 2021
.receipt weekly @user
.wktr, .wt)","text":"Shows who in your server listened to current track or the one you're searching for.
Note that the playcount for the user that requested the command will always be up to date.
Options:
embed or imageExamples
.wt
.whoknowstrack
.whoknowstrack Hothouse Flowers Don't Go
.whoknowstrack Natasha Bedingfield | Unwritten
.fwkt, .fwt)","text":"Shows who from your friends listened to current track or the one you're searching for.
Options:
embed or imageExamples
.fwt
.friendwhoknowstrack
.friendwhoknowstrack Hothouse Flowers Don't Go
.friendwhoknowstrack Natasha Bedingfield | Unwritten
.gwkt, .gwt)","text":"Shows who in .fmbot listened to current track or the one you're searching for.
This searches through all registered .fmbot users. Note that some users with fake playcounts might be excluded.
Options:
Examples
.gwt
.globalwhoknowstrack
.globalwhoknowstrack Hothouse Flowers Don't Go
.globalwhoknowstrack Natasha Bedingfield | Unwritten
Shows top tracks for everyone in your server.
Options:
alltime, monthly or weeklylisteners or playsExamples
.st
.servertracks a p
.servertracks alltime plays
.servertracks listeners weekly
.l)","text":"Adds current track or the one you're searching for to your Last.fm loved tracks.
Examples
.l
.love
.love Tame Impala Borderline
.ul)","text":"Removes current track or the one you're searching for from your Last.fm loved tracks.
Examples
.ul
.unlove
.unlove Lou Reed Brandenburg Gate---
.lt)","text":"Displays a user's loved tracks.
Options:
lfm:username)Examples
.lt
.loved
.lovedtracks
.lovedtracks @user
.sb)","text":"Scrobbles the track you're searching for. You can only scrobble tracks that already exist on Last.fm.
Options:
Artist | Track | AlbumExamples
.scrobble
.sb The Less I Know The Better
.scrobble Loona Heart Attack
.scrobble Mac DeMarco | Chamber of Reflection
.scrobble Home | Climbing Out | Falling into Place
.scrobble https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up
.fmbot uses various ways of making sure all commands are fast and smooth.
This includes storing a copy of your Last.fm history and storing what registered .fmbot members are in which server.
Most of this is done automatically behind the scenes, but you can also adjust this manually.
"},{"location":"commands/whoknows/#update","title":".update","text":"This command updates your playcount cache in the bot. This works by fetching your latest scrobbles from Last.fm and updating our cache accordingly.
"},{"location":"commands/whoknows/#note","title":"Note:","text":".update full to rebuild your playcount cache.Examples
.u
.update
.update full
If you want .fmbot to store more then just your top 4/5/6k artist/albums/tracks, check out .fmbot supporter!
Having issues with the bot not picking up what you're playing on Spotify? Check out the FAQ entry.
"},{"location":"commands/whoknows/#refreshmembers","title":".refreshmembers","text":"Refreshes the cache of which .fmbot users are in your server for server-wide commands.
"},{"location":"commands/whoknows/#note_1","title":"Note:","text":"Examples
.refreshmembers
.yt)","text":"Gets the Youtube link for the song you're currently listening to, or the one you're searching for.
Youtube embeds will be hidden if the user requesting does not have the 'Embed Links' permission.
Examples
.yt
.youtube
.yt Rick Astley Never Gonna Give You Up
.youtube Hi Stranger
Server settings can only be changed by admins, users with the 'Ban Members' permission or .fmbot admins.
"},{"location":"guildsettings/#configuration","title":".configuration","text":"Shows all server settings in an easy overview.
Use the dropdown to pick a setting that you want to change.
Examples
.config
.serversettings
Sets automatic emoji reactions for every .fm and featured command in your server.
To disable, simply use .serverreactions without any emojis.
Make sure the emojis you enable are on your server, or in a server that .fmbot is also in.
Max amount of emojis is 3. Please put a space between every emoji.
Examples
.serverreactions :PagChomp: :PensiveBlob:
.serverreactions \ud83d\ude00 \ud83d\ude2f \ud83e\udd75
.serverreactions \ud83d\ude00 \ud83d\ude2f :PensiveBlob:
.serverreactions
Enable/disable commands per channel, or completely disable the bot in a channel.
You can also force an fm mode for everyone in the channel.
Use the up/down options to pick the channel you want to change.
Examples
.togglecommand
You can enable/disable commands server-wide.
Examples
.toggleservercommand
This command allows you to change the .fmbot prefix on your server.
Note that you can always mention the bot, this will work regardless of prefix.
Examples
.prefix
@.fmbot prefix
Examples of commands when prefix is set to !
!fm
!chart
!whoknows
!topalbums
!prefix
You can change what users are able to gain crowns, configure other crown settings or completely disable crowns.
These settings can only be changed by admins, users with the 'Ban Members' permission or .fmbot admins.
"},{"location":"guildsettings/crownsettings/#crownthreshold","title":".crownthreshold","text":"Allows you set a minimum amount of plays required for someone to claim a crown.
The default value for this is 30.
Examples
.crownthreshold
Allows you to block users from gaining crowns if they have not been active in a certain amount of days.
A user is counted as active once they use .fmbot.
Examples
.crownactivitythreshold
Allows you to remove a crown and all crown history for a certain artist.
Examples
.killcrown deadmau5
.killcrown the beatles
Removes all crowns from your server.
Examples
.killallcrowns
.killallcrowns confirm
Removes all crowns from a specific user
Examples
.removeusercrowns 748900688129687642
.removeusercrowns lastfmsupport
Blocks a user from getting any crowns. They will still be visible in the whoknows output.
Examples
.crownblock 748900688129687642
.crownblock lastfmsupport
Unblocks a user and allows them to gain crowns again.
Examples
.unblock 748900688129687642
.unblock lastfmsupport
View all blocked members on your server.
Examples
.crownblockedmembers
Automatically adds crowns for your server. If you've done this before, it will update all automatically seeded crowns.
Crown seeding again only updates automatically seeded crowns, not manually claimed crowns.
Examples
.crownseeder
Removes all automatically seeded crowns from your server.
Examples
.killallseededcrowns
.killallseededcrowns confirm
Enables/disables all crowns for your server.
All mentions of crowns will be hidden and all crowns that exist will be removed.
Examples
.togglecrowns
You can use .fmbot webhooks to automatically post the featured music to your own channel.
To see more information about how featured works, click here.
"},{"location":"guildsettings/webhooks/#addwebhook","title":".addwebhook","text":"Adds a webhook to the channel or thread you're in.
Requires the bot to have the 'Manage Webhooks' permission.
To change the channel simply change it in the server integration settings.
To remove the webhook simply delete it from your server integrations.
Examples
.addwebhook
Sends a test message through the webhook you've setup in your server. You can use this to check if you've set everything up correctly.
Examples
.testwebhook
You can change what users appear in the whoknows commands and other commands that use all server members
These settings can only be changed by admins, users with the 'Ban Members' permission or .fmbot admins.
"},{"location":"guildsettings/whoknowsettings/#activitythreshold","title":".activitythreshold","text":"Allows you to filter users from commands that have not been active in a certain amount of days.
A user is counted as active once they use .fmbot.
Examples
.activitythreshold
Blocks a user from appearing in whoknows and from being in any server-wide statistic.
Examples
.block 748900688129687642
.block lastfmsupport
Unblocks a user from appearing in whoknows and from being in any server-wide statistic.
Also unblocks a user in case of any crown bans.
Examples
.unblock 748900688129687642
.unblock lastfmsupport
View all blocked members on your server.
Examples
.blockedmembers
.fmbot is a social Discord bot that provides music statistics for you, your friends, and your fellow server members. Easily see who listens to your favorite artist in a server and make new friends. Or discover new artists within your favorite genres.
The bot connects to a Last.fm account to see your listening history. Over 800.000 users have already connected. To get started, create a Last.fm account and afterwards use /login in the bot.
/fm/fm to make it unique with /mode/WhoKnows in your server to see top listeners for artists and compete for crowns!/server commands/friendsEvery hour we feature a random user with something they've recently listened to. Everyone is able to see this using the /featured command, and anyone who recently used the bot gets a chance to become featured!
The bot will also change it's profile picture to the album cover of the feature. Want to be alerted when you get featured? Join our server and you'll get a ping.
"},{"location":"#links","title":"\ud83d\udd17Links:","text":".fmbot is trusted by over 400.000 servers, has over 800.000 registered users, and is used more than 500.000 times every day.
Even since the bot was created in 2017 we've been hard at work at providing the best and easiest to use music statistics.
Thank you to all our generous supporters. Support .fmbot too and get some nice perks in return. "},{"location":"botscrobbling/","title":"Music bot scrobbling","text":"Bot scrobbling is a new feature from .fmbot that allows you to automatically scrobble music from other Discord music bots to your Last.fm account.
The feature works fully automatic. Simply start listening to music using a supported bot and .fmbot will scrobble it for users in that voice channel.
The bot will only scrobble songs it can find on Last.fm. The scrobbling works best with Spotify songs.
"},{"location":"botscrobbling/#currently-supported-bots","title":"Currently supported bots:","text":"/loginUse this command to disable/enable bot scrobbling for your account or to check if you are ready for scrobbling.
Examples
/botscrobbling
Info
Please note that .fmbot is not affiliated with any of these music bots, and that .fmbot does not stream music or download music to Discord in any way.
"},{"location":"faq/","title":"Frequently Asked","text":""},{"location":"faq/#how-do-i-get-started","title":"How do I get started?","text":"This bot uses your music history for various commands. For this we use a website called Last.fm. This site allows you to track your music history from various platforms.
To get started you need to create a Last.fm account. After you've setup your account there you can connect your account to our bot by using /login within Discord.
While we require a Last.fm account the bot is not affiliated with Last.fm.
"},{"location":"faq/#commands-are-showing-the-wrong-songs-its-not-showing-what-i-listen-to-on-spotify","title":"Commands are showing the wrong songs / it's not showing what I listen to on Spotify","text":"We get what you're playing directly from your Last.fm profile, so please check there first to see what is showing on your profile.
Last.fm often has issues with their Spotify connection. For most people it helps to reconnect Spotify in their Last.fm application settings.
Last.fm also has an official guide on how to fix this.
.fmbot is not affiliated with Last.fm or Spotify, so we can't fix this for you. Please don't join our support server to complain about this issue.
"},{"location":"faq/#the-playcounts-in-the-bot-dont-match-lastfm","title":"The playcounts in the bot don't match Last.fm!","text":"Because we rely heavily on caching your playcounts to keep our commands fast it can sometimes happen that you don't get updated properly.
In this case, try to use .update full. This completely re-builds the stored playcounts the bot has for you.
Check out the importing page for more info.
Using imports requires an active supporter subscription.
"},{"location":"faq/#can-i-use-the-bot-in-dms-or-group-chats","title":"Can I use the bot in DM's or group chats?","text":"Yes! Just add fmbot as a user app onto your Discord account.
This way you'll be able to use slash commands from the bot in DM's, group chats and servers without .fmbot.
Click here to add the bot to your Discord account
"},{"location":"faq/#who-picks-what-is-featured","title":"Who picks what is featured?","text":"The bot randomly picks any user that has used .fmbot in the last day.
For more information, check out Featured
"},{"location":"faq/#how-do-i-remove-someone-from-whoknows","title":"How do I remove someone from WhoKnows?","text":"Please check the server WhoKnows settings.
"},{"location":"faq/#im-not-visible-in-global-whoknows","title":"I'm not visible in Global WhoKnows","text":"We sometimes remove or filter users from Global WhoKnows for various reasons, like sleep scrobbling, manipulating scrobbles or other reasons. If you're not showing on the global charts this could be the case.
You can use the .privacy command to check your status. Set your privacy to global and it will be visible, along with all info required. If youre're removed, please fully read this as it contains all the information you need.
Users get filtered automatically for 3 months from Global WhoKnows when:
We are not affiliated with Last.fm. This bot only uses their API to show you and your friends their statistics.
If you have issues with Last.fm, we'd suggest you check out their support forums or their Discord server.
"},{"location":"faq/#the-bot-is-offline","title":"The bot is offline","text":"It could be that it just happens to be updating. If it stays down, please join the support server and ping one of the developers.
"},{"location":"faq/#what-is-the-difference-between-the-normal-bot-and-the-develop-bot","title":"What is the difference between the normal bot and the develop bot?","text":"The develop bot is used to test new fixes and functionality before they go to the normal bot. This is usually announced in #beta-updates on our server.
This bot can have more downtime and bugs than the normal bot, so that is something to keep in mind. The bots currently share the same database, so switching is easy.
Note that if either bot leaves your server all your server data and settings will be cleared.
"},{"location":"faq/#i-like-this-bot","title":"I like this bot","text":"Cool, great to hear.
"},{"location":"faq/#i-dont-like-this-bot","title":"I don't like this bot","text":":( Please let us know why in the support server. We're open to all feedback and happy to help.
"},{"location":"faq/#is-there-any-way-to-support-the-bot","title":"Is there any way to support the bot?","text":"To support us financially, check out .fmbot supporter. You help us with the hosting and development of the bot while getting some nice perks in return.
If you are familiar with C# / .NET you can also help us out and pick up one of the open issues. Please check out our contributing guidelines first.
"},{"location":"faq/#why-does-this-bot-exist","title":"Why does this bot exist?","text":"This bot was made by BitL back in September 2017 and was inspired by UB3R Bot. Back then the bot just had .fm, the charts, featuring and .fmyoutube.
Frikandel joined in when he had the idea of .friends, but was too lazy to make his own bot. Together they moved the bot from text files to an actual database and made various other improvements.
Since 2019 Frikandel has been the main maintainer and hoster of .fmbot, adding commands like .whoknows and other much-requested features. In March 2021 Frikandel took over all parts of the bot.
Join our server here and ask in the #help channel.
Note that since .fmbot and Last.fm are two seperate things. .fmbot is the Discord bot, Last.fm is the website.
Need help with Last.fm? Check out their support forums or their Discord server.
"},{"location":"importing/","title":"Importing your music history","text":"The bot uses Last.fm by default for all your music data. We now also offer a way to import your listening history from Spotify and Apple Music and combine that together with your scrobbles.
The bot will adjust your Last.fm stats on the fly and dynamically add your imports on top.
This feature is only available for .fmbot supporters. Dont have supporter yet? Get it here.
"},{"location":"importing/#import-manage","title":"/import manage","text":"Allows you to manage your imports and pick the source for your playcounts.
You can pick between the following modes:
To delete your imports from .fmbot, switch to the Last.fm option and use the provided button.
Examples
/import manage
Allows you to import your Spotify streaming history in the bot.
Shows the instructions on how to get started if you attach no files. These instructions are also listed below.
This command only supports the 'Extended Streaming History' package. You can either upload the my_spotify_data.zip to import everything at once or upload each .json file separately.
Examples
/import Spotify
Using Discord on your phone?
Discord mobile currently has a bug where it might return Not a valid value. Please try importing your files through Discord desktop. We've reported this bug, sorry for the inconvenience.
/import Spotify slash command and add the .zip file as an attachment through the options.json file separatelyAllows you to import your Apple Music streaming history in the bot.
Shows the instructions on how to get started if you attach no files. These instructions are also listed below.
Examples
/import applemusic
/import applemusic slash command and add the .zip file as an attachment through the optionApple Music Play Activity.csv file separatelyImporting helps your music history be as complete as possible. Most people have been using streaming services like Spotify before they signed up for Last.fm, which means they don't have their full history.
Importing helps you combine your full history together with your current Last.fm data for the best .fmbot experience.
You get to keep your original listening timestamps added together with how long you listened to each track for more accurate listening time stats.
"},{"location":"importing/#the-import-command-keeps-saying-my-files-are-invalid","title":"The import command keeps saying my files are invalid.","text":"For Spotify we only support files from the 'Extended streaming history' package. You can try uploading the my_spotify_data.zip or attach each .json file separately.
Still having issues? Please open a thread on our server.
"},{"location":"importing/#its-adding-less-plays-to-my-fmbot-account-then-expected","title":"It's adding less plays to my .fmbot account then expected","text":"Try switching modes with the /import manage command. This changes how your imports are combined with your Last.fm scrobbles.
If you want to dive deeper, use the .importdebug command. You can also filter this command to a specific artist.
Spotify sends their files out in waves. For the extended streaming history package they usually do this once every 3 weeks.
Apple Music sends your file within a week.
"},{"location":"importing/#my-apple-music-imports-are-too-big-for-discord-and-i-dont-have-nitro","title":"My Apple Music imports are too big for Discord, and I don't have Nitro","text":"Try putting the Apple Music Play Activity.csv file in a .zip and using that.
If it does't work or it's not possible, you can also try in our support server which is boosted and has a higher file size limit for everyone.
"},{"location":"importing/#does-importing-in-fmbot-add-scrobbles-to-my-lastfm","title":"Does importing in .fmbot add scrobbles to my Last.fm?","text":"No, imported data only shows in the bot. No scrobbles are added to your Last.fm.
"},{"location":"importing/#what-happens-if-i-cancel-my-supporter-subscription","title":"What happens if I cancel my supporter subscription?","text":"Importing in .fmbot is a service that adjusts your Last.fm stats on the fly and adds your imported plays on top. If your supporter subscription expires, this service is no longer available and the bot will only use your Last.fm stats.
Your imported plays are however saved and will be available again if you resubscribe in the future.
"},{"location":"importing/#are-platforms-other-then-spotify-and-apple-music-also-supported","title":"Are platforms other then Spotify and Apple Music also supported?","text":"At the moment we only support Spotify and Apple Music.
Want a different platform to be supported? Open a help thread in our server. It helps if you have a data export ready for the developers, so that way they can test a possible integration.
Each platform should have some way for you to request your listening data. This is legally required in Europe, California and various other places around the world.
"},{"location":"importing/#can-i-change-or-delete-my-imports","title":"Can I change or delete my imports?","text":"See the /import manage command.
"},{"location":"importing/#what-data-from-my-imports-do-you-store","title":"What data from my imports do you store?","text":"We only store the following information:
Warning
Imports contain personal data like your IP address and username. Never post your import files publicly.
"},{"location":"privacy/","title":"Privacy","text":"What data .fmbot collects, how we use it and how you can manage it.
Last update: 2023-10-12
Changelog: Update command log storage policy
"},{"location":"privacy/#what-does-your-application-do","title":"What does your application do?","text":".fmbot is an open-source Last.fm Discord bot. Last.fm is a service that tracks what people listen to.
In our bot you can do various things to analyze your and your friends music taste, like see your recent plays or see who in a server listens to a certain artist.
To use the bot, you have to log in with a Last.fm account. After that you can optionally also login with a Discogs account.
"},{"location":"privacy/#what-data-do-you-store","title":"What data do you store?","text":"When someone logins to the bot, we store the following Discord data:
We store the following Last.fm data for every user:
If a user logs in with Discogs, we store the following data:
When the bot joins a server, the following data from that server is stored:
When specific settings for a server channel are set, the following data from that channel is stored:
When someone uses a command, the command log stores this:
If someone imports their Spotify history, we store the following data of their import files:
If a server has Premium Server, the following data will be stored for every logged-in user in the server:
No data is stored from users that are not logged into the bot.
'Logged in' means that a user has connected their Last.fm account to .fmbot with the 'login' command.
"},{"location":"privacy/#music-bot-scrobbling","title":"Music bot scrobbling","text":"If you have logged into the bot the bot will scrobble (store) songs music bots play to your Last.fm profile by default. You can opt-out of this feature by using the /botscrobbling command.
For this feature the bot tries to fetch the artist and track name from messages music bots send in your server. If a song is successfully found, it will be send to Last.fm. No message content is stored or processed otherwise.
"},{"location":"privacy/#for-what-purpose-do-you-store-it","title":"For what purpose do you store it?","text":"To identify who is calling the command and get the appropriate parameters to customize their command.
Music data and server data is used for commands that provide server-wide leaderboards and statistics.
This data is stored for caching purposes and to ensure our commands are performant. It is not possible to fetch data like playcounts for thousands of users real-time.
Command logs are used for statistics, debugging and helping people with bug reports.
"},{"location":"privacy/#for-how-long-do-you-store-it","title":"For how long do you store it?","text":"Settings data and command logs: Forever, or until deleted.
Server data: Forever, or until the bot is kicked from the server.
"},{"location":"privacy/#what-is-the-process-for-users-to-request-deletion-of-their-data","title":"What is the process for users to request deletion of their data?","text":"For user data we have a command (/remove).
For server data people can remove the bot and all the data related to that server will be deleted.
Users can also request deletion of their data in our support server.
"},{"location":"privacy/#what-systems-and-infrastructure-do-you-use","title":"What systems and infrastructure do you use?","text":".fmbot is currently hosted on a Hetzner VPS in Germany.
"},{"location":"privacy/#how-can-users-contact-you-with-security-issues","title":"How can users contact you with security issues?","text":"Through our server and DMs, or through Github issues. We are visibly identified as developers on the server.
"},{"location":"privacy/#does-your-app-utilize-other-third-party-auth-services-or-connections","title":"Does your app utilize other third-party auth services or connections?","text":"We provide auth services to the following services:
Personal .fmbot data will never be shared with any 3rd party services unless explicitly specified.
If you have any questions after reading all this feel free to contact us on our Discord or open an issue on our Github.
"},{"location":"setup/","title":"Development","text":"Setup guide for developers who wish to contribute. Selfhosting .fmbot is not supported.
"},{"location":"setup/#installing-the-database","title":"Installing the database","text":"config.json file later.Viewing the data
To view the data in the database, use pgadmin and click the fmbot database > schemas > public > tables.
"},{"location":"setup/#development_1","title":"Development","text":"config.json that's located in the bin folder. You will have to enter your own configuration values there.frikandel on Discord, or see our serverThe bot requires an internal API for some cache-heavy tasks.
This API is not publicly available, you should however be able to run and debug the bot without it for local development.
"},{"location":"setup/#getting-api-keys","title":"Getting API keys","text":""},{"location":"setup/#discord","title":"Discord","text":".fmbot is open-source and free to use. Optionally you can get supporter to help support the development of the bot and receive the following extra features and benefits.
You can get supporter either directly through Discord or through OpenCollective.
Discord
Monthly $3.99OpenCollective
Monthly $3.99 Yearly $29.99 Lifetime $49.99 Free Supporter Help us pay for hosting, development and other costs \u274c \u2705 Import and use your full Spotify history \u274c \u2705 New Import and use your full Apple Music history \u274c \u2705 Added friends limit 12 18 Personal automatic emoji reactions with.userreactions \u274c \u2705 Custom fm footer options 4 9 Get a better GPT-4 powered .judge command with higher limits and the ability to use the command on others \u274c \u2705 View when you discovered artists with the .discoveries command \u274c \u2705 New Play unlimited jumble games \u274c \u2705 Discovery dates in artist, album and track \u274c \u2705 Years and listening time overview in profile \u274c \u2705 Artist Discoveries and months in year \u274c \u2705 Lifetime history in recent and overview \u274c \u2705 Higher chance of getting featured on Supporter Sunday \u274c \u2705 Supporter badge \u2b50 \u274c \u2705 Chance to sponsor bot-wide charts \u274c \u2705 Your name in the supporters command \u274c \u2705 Exclusive role and channel on our Discord with sneak peeks of new features \u274c \u2705 Cached scrobble history Up to 1.5y Lifetime Cached artists Top 4000 Unlimited Cached albums Top 5000 Unlimited Cached tracks Top 6000 Unlimited Cached Discogs collection Last 100 Unlimited Thank you to all our generous supporters. "},{"location":"supporter/#frequently-asked","title":"Frequently asked","text":""},{"location":"supporter/#why-a-supporter-program","title":"Why a supporter program? In order to help us pay for hosting, fund development and deal with other expenses we've added a way for people to donate. In return for your support you get some cool exclusive perks.
We're dedicated to making sure the bot remains free and independent. That's why most supporter features are simply features that are nice but would be difficult to roll out to everyone. For example some of the extra statistics require us to store your full listening history, which would be difficult to do for all our users.
By getting supporter you help us to be able to spend more time working on new features and fixes, which in return improves the user experience for everyone.
","text":""},{"location":"supporter/#how-do-i-activate-my-subscription","title":"How do I activate my subscription?If you purchase through Discord it should get automatically activated within a minute.
If you have purchased through OpenCollective it needs to be added manually. Join our Discord and create a thread in #help. A staff member will apply it to your account as soon as possible.
","text":""},{"location":"supporter/#what-is-opencollective","title":"What is OpenCollective?OpenCollective is like Patreon, except for open source projects. It's also more transparent and easier when working with multiple people.
They manage our funds and allow us to focus on development while they handle the financial side of things.
OpenCollective relies on Stripe to handle their payments, which is one of the worlds biggest payment providers. You can read more about their security here.
","text":""},{"location":"supporter/#can-i-cancel-or-change-my-subscription","title":"Can I cancel or change my subscription?If you have purchased through Discord, you can go to settings and then 'Subscriptions'.
If you have puchased through OpenCollective, you can cancel a recurring contribution at any time. To do so, go to OpenCollective and sign in. After signing in go to 'Manage Contributions' where you can change your subscription.
","text":""},{"location":"supporter/#what-happens-if-i-cancel-my-subscription-and-have-imported-my-plays","title":"What happens if I cancel my subscription and have imported my plays?Importing in .fmbot is a service that adjusts your Last.fm stats on the fly and adds your imported plays on top. If your supporter subscription expires, this service is no longer available and the bot will only use your Last.fm stats.
Your imported plays are however saved and will be available again if you resubscribe in the future.
","text":""},{"location":"supporter/#does-being-an-fmbot-supporter-give-me-lastfm-pro-or-the-other-way-around","title":"Does being an .fmbot supporter give me Last.fm Pro? Or the other way around?No, .fmbot is not affiliated with Last.fm.
","text":""},{"location":"supporter/#i-have-a-question-that-isnt-listed-here","title":"I have a question that isn't listed herePlease join our server and make a thread in the #help channel. A staff member will try to help you as soon as possible.
","text":""},{"location":"terms/","title":"Terms of Use","text":"Last updated: October 12, 2023
"},{"location":"terms/#agreement-to-terms","title":"Agreement to Terms","text":"These Terms of Use constitute a legally binding agreement made between you, whether personally or on behalf of an entity (\u201cyou\u201d) and .fmbot (\".fmbot\" \u201cfmbot\u201d, \u201cwe\u201d, \u201cus\u201d, or \u201cour\u201d), concerning your access to and use of .fmbot as well as any other media form, website, media channel, mobile website or mobile application related, linked, or otherwise connected thereto (collectively, the \u201cBot\u201d). You agree that by accessing the Bot, you have read, understood, and agree to be bound by all of these Terms of Use. IF YOU DO NOT AGREE WITH ALL OF THESE TERMS OF USE, THEN YOU ARE EXPRESSLY PROHIBITED FROM USING THE BOT AND YOU MUST DISCONTINUE USE IMMEDIATELY. Supplemental terms and conditions or documents that may be posted on the website from time to time are hereby expressly incorporated herein by reference. We reserve the right, in our sole discretion, to make changes or modifications to these Terms of Use from time to time. We will alert you about any changes by updating the \u201cLast updated\u201d date of these Terms of Use, and you waive any right to receive specific notice of each such change. Please ensure that you check the applicable Terms every time you use our Bot so that you understand which Terms apply. You will be subject to, and will be deemed to have been made aware of and to have accepted, the changes in any revised Terms of Use by your continued use of the Bot after the date such revised Terms of Use are posted. The information provided on the Bot is not intended for distribution to or use by any person or entity in any jurisdiction or country where such distribution or use would be contrary to law or regulation or which would subject us to any registration requirement within such jurisdiction or country. Accordingly, those persons who choose to access the Bot from other locations do so on their own initiative and are solely responsible for compliance with local laws, if and to the extent local laws are applicable. The Bot is not tailored to comply with industry-specific regulations (Health Insurance Portability and Accountability Act (HIPAA), Federal Information Security Management Act (FISMA), etc.), so if your interactions would be subjected to such laws, you may not use this Bot. You may not use the Bot in a way that would violate the Gramm-Leach-Bliley Act (GLBA). The Bot is intended for users who are at least 13 years of age. All users who are minors in the jurisdiction in which they reside (generally under the age of 18) must have the permission of, and be directly supervised by, their parent or guardian to use the Bot. If you are a minor, you must have your parent or guardian read and agree to these Terms of Use prior to you using the Bot.
"},{"location":"terms/#user-representations","title":"User Representations","text":"By using the Bot, you represent and warrant that: (1) you have the legal capacity and you agree to comply with these Terms of Use; (2) you are not under the age of 13; (3) you are not a minor in the jurisdiction in which you reside, or if a minor, you have received parental permission to use the Bot; (4) you will not access the Discord Bot through automated or non-human means, whether through a bot, script or otherwise; (5) you will not use the Bot for any illegal or unauthorized purpose; and (6) your use of the Bot will not violate any applicable law or regulation.
"},{"location":"terms/#fees-and-payment","title":"Fees and Payment","text":"We use OpenCollective and Discord for payments.
When you use Discord for any purchases, you must agree to their Paid Services Terms:
https://support.discord.com/hc/en-us/articles/4410339366295
If you have payment issues, you can contact them here:
https://dis.gd/billing
When you use OpenCollective, you must agree to their Terms of Service and Privacy Policy:
https://opencollective.com/tos
https://opencollective.com/privacypolicy
If you have payment issues with OpenCollective, try contacting them. fmbot has limited access to help you resolve issues.
"},{"location":"terms/#prohibited-activities","title":"Prohibited Activities","text":"You may not access or use the Bot for any purpose other than that for which we make the Bot available. The Bot may not be used in connection with any commercial endeavors except those that are specifically endorsed or approved by us.
As a user of the Bot, you agree not to:
You and the Bot agree that we may access, store, process, and use any information and personal data that you provide following the terms of the Privacy Policy and your choices (including settings). By submitting suggestions or other feedback regarding the Bot, you agree that we can use and share such feedback for any purpose without compensation to you. We do not assert any ownership over your Contributions. You retain full ownership of all of your Contributions and any intellectual property rights or other proprietary rights associated with your Contributions. We are not liable for any statements or representations in your Contributions provided by you in any area on the Bot. You are solely responsible for your Contributions to the Bot and you expressly agree to exonerate us from any and all responsibility and to refrain from any legal action against us regarding your Contributions.
"},{"location":"terms/#submissions","title":"Submissions","text":"You acknowledge and agree that any questions, comments, suggestions, ideas, feedback, or other information regarding the Bot (\"Submissions\") provided by you to us are non-confidential and shall become our sole property. We shall own exclusive rights, including all intellectual property rights, and shall be entitled to the unrestricted use and dissemination of these Submissions for any lawful purpose, commercial or otherwise, without compensation to you. You hereby waive all moral rights to any such Submissions, and you hereby warrant that any such Submissions are original with you or that you have the right to submit such Submissions. You agree there shall be no recourse against us for any alleged or actual infringement or misappropriation of any proprietary right in your Submissions.
"},{"location":"terms/#third-party-websites-and-content","title":"Third-Party Websites and Content","text":"The Bot may contain (or you may be sent via the Bot) links to other websites (\"Third-Party Websites\") as well as articles, photographs, text, graphics, pictures, designs, music, sound, video, information, applications, software, and other content or items belonging to or originating from third parties (\"Third-Party Content\"). Such Third-Party Websites and Third-Party Content are not investigated, monitored, or checked for accuracy, appropriateness, or completeness by us, and we are not responsible for any Third-Party Websites accessed through the Bot or any Third-Party Content posted on, available through, or installed from the Bot, including the content, accuracy, offensiveness, opinions, reliability, privacy practices, or other policies of or contained in the Third-Party Websites or the Third-Party Content. Inclusion of, linking to, or permitting the use or installation of any Third-Party Websites or any Third-Party Content does not imply approval or endorsement thereof by us. If you decide to leave the Bot and access the Third-Party Websites or to use or install any Third-Party Content, you do so at your own risk, and you should be aware these Terms of Use no longer govern. You should review the applicable terms and policies, including privacy and data gathering practices, of any website to which you navigate from the Bot or relating to any applications you use or install from the Bot. Any purchases you make through Third-Party Websites will be through other websites and from other companies, and we take no responsibility whatsoever in relation to such purchases which are exclusively between you and the applicable third party. You agree and acknowledge that we do not endorse the products or services offered on Third-Party Websites and you shall hold us harmless from any harm caused by your purchase of such products or services. Additionally, you shall hold us harmless from any losses sustained by you or harm caused to you relating to or resulting in any way from any Third-Party Content or any contact with Third-Party Websites.
"},{"location":"terms/#bot-management","title":"Bot Management","text":"We reserve the right, but not the obligation, to: (1) monitor the Bot for violations of these Terms of Use; (2) take appropriate action against anyone who, in our sole discretion, violates the law or these Terms of Use, including without limitation, reporting such user to law enforcement authorities; (3) in our sole discretion and without limitation, refuse, restrict access to, limit the availability of, or disable (to the extent technologically feasible) any of your Contributions or any portion thereof; (4) in our sole discretion and without limitation, notice, or liability, to remove from the Bot or otherwise disable all files and content that are excessive in size or are in any way burdensome to our systems; and (5) otherwise manage the Bot in a manner designed to protect our rights and property and to facilitate the proper functioning of the Bot.
"},{"location":"terms/#privacy-policy","title":"Privacy Policy","text":"We care about data privacy and security. Please review our Privacy Policy: https://fmbot.xyz/privacy. By using the Bot, you agree to be bound by our Privacy Policy, which is incorporated into these Terms of Use. Please be advised the Bot is hosted in Finland. If you access the Bot from any other region of the world with laws or other requirements governing personal data collection, use, or disclosure that differ from applicable laws in Finland, then through your continued use of the Bot, you are transferring your data to Finland, and you agree to have your data transferred to and processed in Finland. Further, we do not knowingly accept, request, or solicit information from children or knowingly market to children. Therefore, in accordance with the U.S. Children\u2019s Online Privacy Protection Act, if we receive actual knowledge that anyone under the age of 13 has provided personal information to us without the requisite and verifiable parental consent, we will delete that information from the Bot as quickly as is reasonably practical.
"},{"location":"terms/#term-and-termination","title":"Term and Termination","text":"These Terms of Use shall remain in full force and effect while you use the Bot. WITHOUT LIMITING ANY OTHER PROVISION OF THESE TERMS OF USE, WE RESERVE THE RIGHT TO, IN OUR SOLE DISCRETION AND WITHOUT NOTICE OR LIABILITY, DENY ACCESS TO AND USE OF THE BOT (INCLUDING BLOCKING CERTAIN IP ADDRESSES), TO ANY PERSON FOR ANY REASON OR FOR NO REASON, INCLUDING WITHOUT LIMITATION FOR BREACH OF ANY REPRESENTATION, WARRANTY, OR COVENANT CONTAINED IN THESE TERMS OF USE OR OF ANY APPLICABLE LAW OR REGULATION. WE MAY TERMINATE YOUR USE OR PARTICIPATION IN THE BOT OR DELETE ANY CONTENT OR INFORMATION THAT YOU POSTED AT ANY TIME, WITHOUT WARNING, IN OUR SOLE DISCRETION. If we terminate or suspend your access for any reason, you are prohibited from using a new account under your name, a fake or borrowed name, or the name of any third party, even if you may be acting on behalf of the third party. In addition to terminating or suspending your account, we reserve the right to take appropriate legal action, including without limitation pursuing civil, criminal, and injunctive redress.
"},{"location":"terms/#modifications-and-interruptions","title":"Modifications and Interruptions","text":"We reserve the right to change, modify, or remove the contents of the bot at any time or for any reason at our sole discretion without notice. While we will make a best effort to inform our users we have no obligation to update any information on our bot. We also reserve the right to modify or discontinue all or part of the bot without notice at any time. We will not be liable to you or any third party for any modification, price change, suspension, or discontinuance of the bot. We cannot guarantee the bot will be available at all times. We may experience hardware, software, or other problems or need to perform maintenance related to the bot, resulting in interruptions, delays, or errors. We reserve the right to change, revise, update, suspend, discontinue, or otherwise modify the bot at any time or for any reason without notice to you. You agree that we have no liability whatsoever for any loss, damage, or inconvenience caused by your inability to access or use the bot during any downtime or discontinuance of the bot. Nothing in these Terms of Use will be construed to obligate us to maintain and support the bot or to supply any corrections, updates, or releases in connection therewith.
"},{"location":"terms/#governing-law","title":"Governing Law","text":"These conditions are governed by and interpreted following the laws of the Netherlands, and the use of the United Nations Convention of Contracts for the International Sale of Goods is expressly excluded. If your habitual residence is in the EU, and you are a consumer, you additionally possess the protection provided to you by obligatory provisions of the law of your country of residence. .fmbot and yourself both agree to submit to the non-exclusive jurisdiction of the courts of The Netherlands, which means that you may make a claim to defend your consumer protection rights in regards to these Conditions of Use in the Netherlands, or in the EU country in which you reside.
"},{"location":"terms/#corrections","title":"Corrections","text":"There may be information on the bot that contains typographical errors, inaccuracies, or omissions, including descriptions, pricing, availability, and various other information. We reserve the right to correct any errors, inaccuracies, or omissions and to change or update the information on the bot at any time, without prior notice.
"},{"location":"terms/#disclaimer","title":"Disclaimer","text":"THE BOT IS PROVIDED ON AN AS-IS AND AS-AVAILABLE BASIS. YOU AGREE THAT YOUR USE OF THE SITE AND OUR SERVICES WILL BE AT YOUR SOLE RISK. TO THE FULLEST EXTENT PERMITTED BY LAW, WE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, IN CONNECTION WITH THE BOT AND YOUR USE THEREOF, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. WE MAKE NO WARRANTIES OR REPRESENTATIONS ABOUT THE ACCURACY OR COMPLETENESS OF THE BOT\u2019S CONTENT OR THE CONTENT OF ANY WEBSITES LINKED TO THE BOT AND WE WILL ASSUME NO LIABILITY OR RESPONSIBILITY FOR ANY (1) ERRORS, MISTAKES, OR INACCURACIES OF CONTENT AND MATERIALS, (2) PERSONAL INJURY OR PROPERTY DAMAGE, OF ANY NATURE WHATSOEVER, RESULTING FROM YOUR ACCESS TO AND USE OF THE BOT, (3) ANY UNAUTHORIZED ACCESS TO OR USE OF OUR SECURE SERVERS AND/OR ANY AND ALL PERSONAL INFORMATION AND/OR FINANCIAL INFORMATION STORED THEREIN, (4) ANY INTERRUPTION OR CESSATION OF TRANSMISSION TO OR FROM THE WEBSITE, (5) ANY BUGS, VIRUSES, TROJAN HORSES, OR THE LIKE WHICH MAY BE TRANSMITTED TO OR THROUGH THE BOT BY ANY THIRD PARTY, AND/OR (6) ANY ERRORS OR OMISSIONS IN ANY CONTENT AND MATERIALS OR FOR ANY LOSS OR DAMAGE OF ANY KIND INCURRED AS A RESULT OF THE USE OF ANY CONTENT POSTED, TRANSMITTED, OR OTHERWISE MADE AVAILABLE VIA THE BOT. WE DO NOT WARRANT, ENDORSE, GUARANTEE, OR ASSUME RESPONSIBILITY FOR ANY PRODUCT OR SERVICE ADVERTISED OR OFFERED BY A THIRD PARTY THROUGH THE BOT, ANY HYPERLINKED WEBSITE, OR ANY WEBSITE OR MOBILE APPLICATION FEATURED IN ANY BANNER OR OTHER ADVERTISING, AND WE WILL NOT BE A PARTY TO OR IN ANY WAY BE RESPONSIBLE FOR MONITORING ANY TRANSACTION BETWEEN YOU AND ANY THIRD-PARTY PROVIDERS OF PRODUCTS OR SERVICES. AS WITH THE PURCHASE OF A PRODUCT OR SERVICE THROUGH ANY MEDIUM OR IN ANY ENVIRONMENT, YOU SHOULD USE YOUR BEST JUDGMENT AND EXERCISE CAUTION WHERE APPROPRIATE.
"},{"location":"terms/#limitations-of-liability","title":"Limitations of Liability","text":"IN NO EVENT WILL WE OR OUR DIRECTORS, EMPLOYEES, OR AGENTS BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, SPECIAL, OR PUNITIVE DAMAGES, INCLUDING LOST PROFIT, LOST REVENUE, LOSS OF DATA, OR OTHER DAMAGES ARISING FROM YOUR USE OF THE BOT, EVEN IF WE HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. NOTWITHSTANDING ANYTHING TO THE CONTRARY CONTAINED HEREIN, OUR LIABILITY TO YOU FOR ANY CAUSE WHATSOEVER AND REGARDLESS OF THE FORM OF THE ACTION, WILL AT ALL TIMES BE LIMITED TO THE AMOUNT PAID, IF ANY, BY YOU TO US. CERTAIN US STATE LAWS AND INTERNATIONAL LAWS DO NOT ALLOW LIMITATIONS ON IMPLIED WARRANTIES OR THE EXCLUSION OR LIMITATION OF CERTAIN DAMAGES. IF THESE LAWS APPLY TO YOU, SOME OR ALL OF THE ABOVE DISCLAIMERS OR LIMITATIONS MAY NOT APPLY TO YOU, AND YOU MAY HAVE ADDITIONAL RIGHTS.
"},{"location":"terms/#indemnification","title":"Indemnification","text":"You agree to defend, indemnify, and hold us harmless, including our subsidiaries, affiliates, and all of our respective officers, agents, partners, and employees, from and against any loss, damage, liability, claim, or demand, including reasonable attorneys\u2019 fees and expenses, made by any third party due to or arising out of: (1) use of the Bot; (2) breach of these Terms of Use; (3) any breach of your representations and warranties set forth in these Terms of Use; (4) your violation of the rights of a third party, including but not limited to intellectual property rights; or (5) any overt harmful act toward any other user of the Bot with whom you connected via the Bot. Notwithstanding the foregoing, we reserve the right, at your expense, to assume the exclusive defense and control of any matter for which you are required to indemnify us, and you agree to cooperate, at your expense, with our defense of such claims. We will use reasonable efforts to notify you of any such claim, action, or proceeding which is subject to this indemnification upon becoming aware of it.
"},{"location":"terms/#user-data","title":"User Data","text":"We will maintain certain data that you transmit to the Bot for the purpose of managing the performance of the Bot, as well as data relating to your use of the Bot. Although we perform regular routine backups of data, you are solely responsible for all data that you transmit or that relates to any activity you have undertaken using the Bot. You agree that we shall have no liability to you for any loss or corruption of any such data, and you hereby waive any right of action against us arising from any such loss or corruption of such data.
"},{"location":"terms/#electric-communications-transactions-and-signatures","title":"Electric Communications, Transactions and Signatures","text":"Using the Bot, visiting the website, sending us emails, and completing online forms constitute electronic communications. You consent to receive electronic communications, and you agree that all agreements, notices, disclosures, and other communications we provide to you electronically, via email and on the Bot, satisfy any legal requirement that such communication be in writing. YOU HEREBY AGREE TO THE USE OF ELECTRONIC SIGNATURES, CONTRACTS, ORDERS, AND OTHER RECORDS, AND TO ELECTRONIC DELIVERY OF NOTICES, POLICIES, AND RECORDS OF TRANSACTIONS INITIATED OR COMPLETED BY US OR VIA THE BOT. You hereby waive any rights or requirements under any statutes, regulations, rules, ordinances, or other laws in any jurisdiction which require an original signature or delivery or retention of non-electronic records, or to payments or the granting of credits by any means other than electronic means.
"},{"location":"terms/#california-users-and-residents","title":"California Users and Residents","text":"If any complaint with us is not satisfactorily resolved, you can contact the Complaint Assistance Unit of the Division of Consumer Services of the California Department of Consumer Affairs in writing at 1625 North Market Blvd., Suite N 112, Sacramento, California 95834 or by telephone at (800) 952-5210 or (916) 445-1254.
"},{"location":"terms/#miscellaneous","title":"Miscellaneous","text":"These Terms of Use and any policies or operating rules posted by us on the website or in respect to the Bot constitute the entire agreement and understanding between you and us. Our failure to exercise or enforce any right or provision of these Terms of Use shall not operate as a waiver of such right or provision. These Terms of Use operate to the fullest extent permissible by law. We may assign any or all of our rights and obligations to others at any time. We shall not be responsible or liable for any loss, damage, delay, or failure to act caused by any cause beyond our reasonable control. If any provision or part of a provision of these Terms of Use is determined to be unlawful, void, or unenforceable, that provision or part of the provision is deemed severable from these Terms of Use and does not affect the validity and enforceability of any remaining provisions. There is no joint venture, partnership, employment or agency relationship created between you and us as a result of these Terms of Use or use of the Bot. You agree that these Terms of Use will not be construed against us by virtue of having drafted them. You hereby waive any and all defenses you may have based on the electronic form of these Terms of Use and the lack of signing by the parties hereto to execute these Terms of Use.
"},{"location":"terms/#contact-us","title":"Contact Us","text":"Discord: https://discord.gg/fmbot
"},{"location":"commands/","title":"Getting started","text":"To view a list of all available commands, use the sidebar. The basic commands to get started are listed below.
.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 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.
Have an issue with the bot you need help with? Please check the Frequently Asked section first.
"},{"location":"commands/#login","title":".login","text":"This command connects your Last.fm account to .fmbot.
After using this command the bot will DM you a link where you can allow access to your Last.fm account.
Not receiving a DM from .fmbot when using this command? Please check if you have DMs enabled in the servers privacy settings.
Examples
.login
/login (responds in-channel)
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.
Shows information about getting started with the bot.
Examples
.help
Shows you or someone else their user profile with some interesting statistics.
Options:
lfm:username)Examples
.profile
.stats
Want to see a yearly overview on your profile? Get .fmbot supporter here.
"},{"location":"commands/#settings","title":".settings","text":"Shows an overview of all your .fmbot settings.
Use the dropdown to pick what setting you want to change.
Examples
.settings
/settings (responds in-channel)
This command allows you to change how your .fm command looks.
Available modes:
You can also enable up to 4 custom options to show in your .fm footer.
Use the provided dropdowns to select and de-select which options you want.
Examples
.fmmode
/fmmode (responds in-channel)
Supporters can select up 9 options, and have access to some exclusive options like first artist listen. Get .fmbot supporter here.
"},{"location":"commands/#responsemode","title":".responsemode","text":"This command allows you to change how responses to the various whoknows and top lists commmand look.
Modes: embed or image
You can also override this preference on every invididual command. Simply add img or embed to the command.
Examples
.responsemode
Override examples
.whoknows the beatles image
.toptracks 2023 img
.globalwhoknows mac miller embed
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.
This setting is supporter only. Get .fmbot supporter here.
Examples
.userreactions :PagChomp: :PensiveBlob:
.userreactions \ud83d\ude00 \ud83d\ude2f \ud83e\udd75
.userreactions \ud83d\ude00 \ud83d\ude2f :PensiveBlob:
.userreactions
.ab)","text":"Gets information about current album or the one you're searching for.
Examples
.ab
.album
.album Ventura Anderson .Paak
Want this command to also show the date you discovered an album? Get .fmbot supporter here.
"},{"location":"commands/albums/#albumplays-abp","title":".albumplays (.abp)","text":"Shows you your playcount for current album or the one you're searching for.
Options:
lfm:username)Examples
.abp
.albumplays
.albumplays The Slow Rush
.c)","text":"Creates a chart of your top albums over a certain time period.
Options:
2x2, 3x5 all the way up to 10x10.r:2023)notitles - Don't display album titles. (nt)skipemptyalbums - Skips albums without images. (s or skip)lfm:username)Available time periods: weekly, monthly, quarterly, half, yearly or alltime (w, m, q, h, y or a)
Examples
.c
.chart
.chart 5x5
.chart 8x8 yearly
.chart 6x8 alltime notitles
.chart released:2022
.c 8x10 a nt s
.aoty)","text":"Generates a chart of albums released in a specific year.
It works the exact same as the chart command, except that you can directly input the release year for the filter.
Examples
.aoty 2023
.tab)","text":"Shows a list of you or your friends top albums over a certain time period.
Options:
r:2023)lfm:username)embed or imageTime periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.tab
.topalbums billboard
.tab a bb
.topalbums 2023 @user
.topalbums quarterly @slipper
.topalbums r:2022
.abt)","text":"Shows a list of tracks in an album that you have plays on.
Note that Last.fm or Spotify will sometimes not return the tracks within an album.
Options:
lfm:username)Examples
.abt
.albumtracks
.albumtracks the beatles yesterday
.co)","text":"Shows the cover for current album or the one you're searching for.
Examples
.co
.cover
.cover la priest inji
.cover featured
.wkab, .wa)","text":"Shows who in your server listened to current album or the one you're searching for.
Options:
embed or imageExamples
.wa
.whoknowsalbum
.whoknowsalbum The Beatles Abbey Road
.whoknowsalbum Metallica & Lou Reed | Lulu
.fwkab, .fwa)","text":"Shows who from your friends listened to current album or the one you're searching for.
Options:
embed or imageExamples
.fwa
.friendwhoknowsalbum
.friendwhoknowsalbum The Beatles Abbey Road
.friendwhoknowsalbum Metallica & Lou Reed | Lulu
.gwka, .gwa)","text":"Shows who in .fmbot listened to current album or the one you're searching for.
This searches through all registered .fmbot users. Note that some users with fake playcounts might be excluded.
Options:
embed or imageExamples
.gwa
.globalwhoknowsalbum
.globalwhoknowsalbum The Beatles Abbey Road
.globalwhoknowsalbum Metallica & Lou Reed | Lulu
Shows top albums for everyone in your server.
Options:
alltime, monthly or weeklylisteners or playsExamples
.sab
.serveralbums a p
.serveralbums alltime plays
.serveralbums listeners weekly
.a)","text":"Shows information about current artist or the one you're searching for.
Options:
random/rnd to view a random artist you've listened toExamples
.a
.artist
.a Gorillaz
.artist David Vunk
Want this command to also show the date you discovered an artist? Get .fmbot supporter here.
"},{"location":"commands/artists/#affinity-aff","title":".affinity (.aff)","text":"Shows users in the same server with similar music taste to you.
Uses your alltime top artists and recent top artists.
Options:
lfm:username)Examples
.aff
.affinity
.ap)","text":"Shows you your playcount for the artist you're currently listening to or searching for.
Options:
lfm:username)random/rnd to view a random artist you've listened toExamples
.ap
.artistplays
.artistplays Mall Grab
.ac)","text":"Creates a chart of your top artists over a certain time period.
Options:
2x2, 3x5 all the way up to 10x10.notitles - Don't display artist names. (nt)skip - Skips artists without images. (s)lfm:username)Available time periods: weekly, monthly, quarterly, half, yearly or alltime (w, m, q, h, y or a)
Examples
.ac
.artistchart
.artistchart 5x5
.artistchart 4x8 yearly
.artistchart 8x8 alltime notitles
.artistchart 8x8 alltime notitles skip
.ac 8x10 a nt s
.at)","text":"Shows you your all-time top tracks for current artist or the one you're searching for.
Options:
lfm:username)Examples
.at
.artisttracks
.artisttracks Crystal Castles
.aa)","text":"Shows you your all-time top albums for current artist or the one you're searching for.
Options:
lfm:username)Examples
.aa
.artistalbums
.artistalbums Frank Ocean
.ta)","text":"Shows a list of you or your friends top artists over a certain time period.
Options:
lfm:username)embed or imageTime periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.ta
.artists
.topartists billboard
.ta w bb
.topartists 2023 @user
.topartists alltime @drasil
.t)","text":"Compares your top artists, genres, countries and Discogs to those of someone else.
Options:
Time periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustModes:
t): Default. Works on all platforms, might not properly outline non-unicode characterse): Looks better, but is unreadable on mobile.Examples
.t frikandel_
.t @user
.taste bitldev
.taste @user monthly embed
.t @user m e
.wk, .w)","text":"Shows who in your server listened to current artist or the one you're searching for.
Options:
embed or imagerandom/rnd to view a random artist you've listened toExamples
.w
.wk
.w COMA
.whoknows
.whoknows Agar Agar img
.fwk, .fw)","text":"Shows who from your friends listened to current artist or the one you're searching for.
Options:
embed or imagerandom/rnd to view a random artist you've listened toExamples
.fw
.fwk
.fw COMA
.friendwhoknows
.friendwhoknows KAYTRANADA
.gwk, .gw)","text":"Shows who in .fmbot listened to current artist or the one you're searching for.
This searches through all registered .fmbot users. Note that some users with fake playcounts might be excluded.
Options:
embed or imagerandom/rnd to view a random artist you've listened toExamples
.gw
.gwk
.gw COMA
.globalwhoknows
.globalwhoknows Romy
Shows top artists for everyone in your server.
Options:
alltime, monthly or weeklylisteners or playsExamples
.sa
.serverartists a p
.serverartists alltime plays
.serverartists listeners weekly
.d)","text":"Shows a list of when you discovered artists, together with their alltime playcount.
Options:
lfm:username)Time periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.ta
.artists
.topartists billboard
.ta w bb
.topartists weekly @user
.topartists alltime @drasil
This command requires .fmbot to store your full listening history, which we only do for supporters. Get .fmbot supporter here.
"},{"location":"commands/countries/","title":"Country commands","text":"Countries are sourced from MusicBrainz.
To enter countries, you can either enter the full name or the 2 letter ISO code.
"},{"location":"commands/countries/#topcountriestc","title":".topcountries(.tc)","text":"Shows a list of you or your friends top countries over a certain time period.
Options:
lfm:username)embed or imageTime periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.tc
.topcountries billboard
.topcountries weekly @user
.tc alltime @Voaz bb
.topcountries monthly lfm:fm-bot
.from)","text":"Shows country information for your current artist or your top artists for the country you're searching for.
Examples
.from
.country
.country Netherlands
.country Mac DeMarco
A crown is an award that you get if you're the #1 listener for a certain artist in a server.
To get crowns you can use .whoknows.
Crown server settings are available here. Leaving a server resets all your crowns for that server.
"},{"location":"commands/crowns/#crowns-cws","title":".crowns (.cws)","text":"Shows your top crowns or crowns for a user you're searching for.
Options:
lfm:username)Examples
.cws
.crowns
.crowns @frikandel
.cw)","text":"Shows the current crown owner and crown history for the artist you're currently listening to or searching for.
Examples
.cw
.crown
.crown the beatles
.crown tame impala
.cwlb)","text":"Shows the users with the most crowns on your server.
Examples
.cwlb
.crownleaderboard
Looking for automatic crowns, crown settings and ways to moderate crowns on your server? That's available here in the server setting section.
"},{"location":"commands/discogs/","title":"Discogs commands","text":""},{"location":"commands/discogs/#discogs","title":".discogs","text":"Allows you to connect or manage the connection with your Discogs account.
The bot will send you a DM where you can configure this.
You can also show/hide the display of your collection value on your profile.
Examples
.discogs
Shows you or someone else their Discogs collection.
Allows for searching through artist or album title. One can also search by format type, include cassette, cd or vinyl in the command to enable.
This command updates your stored collection in .fmbot. Your collection can only be updated once per hour.
Some places where your collection can also be visible are the profile, artist, album as well as taste commands if both you and the other user have run .discogs.
Options:
lfm:username)Examples
.collection
.collection mall grab
.collection cd
Only the last 100 items you've added to Discogs can be viewed and stored.
Want to view your whole collection? Get .fmbot supporter here.
"},{"location":"commands/featured/","title":"Featured commands","text":""},{"location":"commands/featured/#featured","title":".featured","text":"Shows the user that is currently featured.
Anyone that is registered in fmbot can get featured, on one condition: They must have used .fmbot in the last day.
Want to be notified when you're featured? Join our server and you'll get a ping.
Possible featured modes:
If your top album doesn't have a picture, no worries. The bot will just grab the next album that has a picture. The album cover will also be used as the bot's profile picture.
Examples
.featured
Every first Sunday of each month is Supporter Sunday. On this day .fmbot picks featured from .fmbot supporters, as a thank you for supporting the bot. Get .fmbot supporter here.
"},{"location":"commands/featured/#featuredlog","title":".featuredlog","text":"Shows your or someone else their featured history.
Options:
lfm:username)Global, Server, Friends or UserExamples
.featuredlog
.featuredlog @user
.featuredlog server
.f)","text":"Shows the latest scrobble of your added friends in a list.
Examples
.friends
Adds one or multiple friends to your friends list.
Select other users by mention, Discord ID or Last.fm username
Examples
.addfriends frikandel_
.addfriends frikandel_ otherlastfmuser
.addfriends frikandel_ @discorduser
.addfriends 356268235697553409
Did you know there's also another way to add friends? Simply rightclick their profile > Apps > Add Friend
Want to be able to add more friends (up to 18)? Get .fmbot supporter here.
"},{"location":"commands/friends/#removefriends","title":".removefriends","text":"Removes one or multiple friends from your friends list.
Select other users by mention, Discord ID or Last.fm username
Examples
.removefriends frikandel_
.removefriends frikandel_ otherlastfmuser
.removefriends frikandel_ @discorduser
.removefriends 356268235697553409
Did you know there's also another way to add friends? Simply rightclick their profile > Apps > Remove Friend
Removes all your friends from your friends list.
Examples
.removeallfriends
.fwk, .fw)","text":"Shows who from your friends listened to an artist you're currently listening to or the one you're searching for.
Options:
Examples
.fw
.fwk
.fw MGMT
.friendwhoknows
.friendwhoknows Nia Archives
.fwkab, .fwa)","text":"Shows who from your friends listened to an album you're currently listening to or the one you're searching for.
Options:
Examples
.fwa
.friendwhoknowsalbum
.friendwhoknowsalbum The Beatles Help
.friendwhoknowsalbum Metallica & Lou Reed | Lulu
.fwkt, .fwt)","text":"Shows who from your friends listened to an track you're currently listening to or the one you're searching for.
Options:
Examples
.fwt
.friendwhoknowstrack
.friendwhoknowstrack Vansire Metamodernity
.friendwhoknowstrack Natasha Bedingfield | Unwritten
.j)","text":"Play the new Jumble game! Guess the artist out of your all-time top artists together with your friends.
Examples
.j
.jumble
Server staff and want to restrict jumble to specific channels? Use .togglecommand
Want to play unlimited jumbles every day? Get .fmbot supporter here.
"},{"location":"commands/games/#pixel-px","title":".pixel (.px)","text":"Play the new Pixel jumble game! Guess the album out of your all-time top albums together with your friends.
Examples
.px
.pixel
Server staff and want to restrict pixel jumble to specific channels? Use .togglecommand
Want to play unlimited pixel jumbles every day? Get .fmbot supporter here.
"},{"location":"commands/genius/","title":"Genius commands","text":""},{"location":"commands/genius/#genius-gen","title":".genius (.gen)","text":"Gets the Genius link for the song you're currently listening to, or the one you're searching for.
Examples
.gen
.genius
.gen Nas Never Die
.genius Mac Miller Good News
Genres are sourced from Spotify.
To view a list of all Spotify genres, you can use the website everynoise.com
"},{"location":"commands/genres/#topgenrestg","title":".topgenres(.tg)","text":"Shows a list of you or your friends top genres over a certain time period.
Options:
lfm:username)embed or imageTime periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.tg
.topgenres billboard
.topgenres weekly @user
.tg alltime @drasil bb
.topgenres 2023 lfm:fm-bot
.g)","text":"Shows genre information for your current artist or your top artists for the genre you're searching for.
Options:
lfm:username)Server or UserExamples
.g
.genre
.genre electro
.genre Mac DeMarco
.g lfm:fm-bot
.wg)","text":"Shows who in your server listened to a genre you're searching for.
Options:
Examples
.wg
.wkg
.wg hiphop
.whoknowsgenre techno
Shows top genres for everyone in your server.
Options:
alltime, monthly or weeklylisteners or playsExamples
.sg
.servergenres a p
.servergenres alltime plays
.servergenres listeners weekly
It's possible to remove .fmbot's response, even if you don't have permission to manage messages.
Mobile: Long press message > Apps > Delete response
Desktop: Right-click message > Apps > Delete response
"},{"location":"commands/misc/#reply-context","title":"Reply context","text":"You can reply to any fmbot command or response that contains an artist, album or track to directly use that as context for your new command.
Example below:
"},{"location":"commands/misc/#judge","title":".judge","text":"Judges your music taste using AI. You can pick between either a compliment or a roast.
Free users can use this command 3 times a day, supporters up to 15.
Supporters also get access to higher quality GPT-4 powered compliments and roasts.
Options:
lfm:username)Examples
.judge
The usage limits for this command might be adjusted depending on popularity and cost.
"},{"location":"commands/misc/#rateyourmusic","title":".rateyourmusic","text":"Enables/disabled an option that changes all album links to link to RateYourMusic.
Examples
.rym
Shows all the information and links related to the bot.
Examples
.info
Gets the bot status information.
Examples
.status
Deletes all your user information, including all your friends and other settings.
Examples
.remove
Shows your last 1 or 2 scrobbles, either in embed or text format.
You can set how your .fm embed looks with the .mode command.
Options:
lfm:username)Examples
.fm
.fm @user
.fm lfm:lastfmusername
.fm this is a nice song
Tip: You can click the embed title to go to the users Last.fm profile.
If you want .fmbot to add reactions to this command, please see .serverreactions.
.r)","text":"Shows your latest plays.
Options:
lfm:username)Examples
.r
.recent
For supporters this command expands to your full listening history. Supporters can also filter to specific artists. Get .fmbot supporter here.
"},{"location":"commands/plays/#streak-str","title":".streak (.str)","text":"Shows your track, album or artist streak.
Options:
lfm:username)Examples
.str
.streak
.o)","text":"Shows you an overview of your top track, album and artist for the last few days.
Options:
lfm:username)Examples
.o
.overview
.overview 8
.pc)","text":"Shows you an estimate of when you will reach a certain amount of plays.
Options:
lfm:username)Time periods: weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)
Examples
.pc
.pace
.pace a 73k
.pace 50000 quarterly
.ms)","text":"Shows you your latest scrobble milestones.
Options:
lfm:username)random/rnd to view a random milestoneExamples
.ms
.ms 30k
.milestone
.milestone 20k
.milestone 1337 @frikandel
.milestone rnd
.wrapped)","text":"Shows you an overview of you or someone else their year.
Supporters get an extra page with Artist Discoveries and a monthly overview.
Options:
lfm:username)Examples
.year
.year 2024
.wrapped @frikandel
.sp)","text":"Gets the Spotify link for the song you're currently listening to, or the one you're searching for.
Examples
.sp
.spotify
.sp C418 Sweden
.spotify Delta Sleep Camp Adventure
.spab)","text":"Gets the Spotify link for the album you're currently listening to, or the one you're searching for.
Examples
.spab
.spotifyalbum
.spab De Jeugd De Lachende Derde
.spotifyalbum Alexander Robotnick April
.spa)","text":"Gets the Spotify link for the artist you're currently listening to, or the one you're searching for.
Examples
.spa
.spotifyartist
.spa Green Day
.spotifyartist Acid Pauli
.tr)","text":"Gets information about the track you're currently listening to or searching for.
Examples
.tr
.track
.track Kaytranada You're The One
Want this command to also show the date you discovered a track? Get .fmbot supporter here.
"},{"location":"commands/tracks/#trackplays-tp","title":".trackplays (.tp)","text":"Shows you your playcount for current track or the one you're searching for.
Options:
lfm:username)Examples
.tp
.trackplays
.trackplays Infected Mushroom Can't Stop
.td)","text":"Shows metadata for current track or the one you're searching for.
Examples
.td
.trackdetails
.trackdetails Underworld Born Slippy
.r)","text":"Shows your latest plays.
Options:
lfm:username)Examples
.r
.recent
For supporters this command expands to your full listening history. Get .fmbot supporter here.
"},{"location":"commands/tracks/#toptracks-tt","title":".toptracks (.tt)","text":"Shows a list of you or your friends top tracks over a certain time period.
Options:
lfm:username)embed or imageTime periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.tt
.toptracks billboard
.tt y bb
.toptracks 2023 @user
.toptracks @john alltime
.rcpt)","text":"Shows your track receipt. Based on Receiptify.
Options:
lfm:username)Time periods:
weekly, monthly, quarterly, half, yearly or alltime. (w, m, q, h, y or a)2023, Mar 2020, AugustExamples
.rcpt
.receipt
.receipt march 2021
.receipt weekly @user
.wktr, .wt)","text":"Shows who in your server listened to current track or the one you're searching for.
Note that the playcount for the user that requested the command will always be up to date.
Options:
embed or imageExamples
.wt
.whoknowstrack
.whoknowstrack Hothouse Flowers Don't Go
.whoknowstrack Natasha Bedingfield | Unwritten
.fwkt, .fwt)","text":"Shows who from your friends listened to current track or the one you're searching for.
Options:
embed or imageExamples
.fwt
.friendwhoknowstrack
.friendwhoknowstrack Hothouse Flowers Don't Go
.friendwhoknowstrack Natasha Bedingfield | Unwritten
.gwkt, .gwt)","text":"Shows who in .fmbot listened to current track or the one you're searching for.
This searches through all registered .fmbot users. Note that some users with fake playcounts might be excluded.
Options:
Examples
.gwt
.globalwhoknowstrack
.globalwhoknowstrack Hothouse Flowers Don't Go
.globalwhoknowstrack Natasha Bedingfield | Unwritten
Shows top tracks for everyone in your server.
Options:
alltime, monthly or weeklylisteners or playsExamples
.st
.servertracks a p
.servertracks alltime plays
.servertracks listeners weekly
.l)","text":"Adds current track or the one you're searching for to your Last.fm loved tracks.
Examples
.l
.love
.love Tame Impala Borderline
.ul)","text":"Removes current track or the one you're searching for from your Last.fm loved tracks.
Examples
.ul
.unlove
.unlove Lou Reed Brandenburg Gate---
.lt)","text":"Displays a user's loved tracks.
Options:
lfm:username)Examples
.lt
.loved
.lovedtracks
.lovedtracks @user
.sb)","text":"Scrobbles the track you're searching for. You can only scrobble tracks that already exist on Last.fm.
Options:
Artist | Track | AlbumExamples
.scrobble
.sb The Less I Know The Better
.scrobble Loona Heart Attack
.scrobble Mac DeMarco | Chamber of Reflection
.scrobble Home | Climbing Out | Falling into Place
.scrobble https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up
.fmbot uses various ways of making sure all commands are fast and smooth.
This includes storing a copy of your Last.fm history and storing what registered .fmbot members are in which server.
Most of this is done automatically behind the scenes, but you can also adjust this manually.
"},{"location":"commands/whoknows/#update","title":".update","text":"This command updates your playcount cache in the bot. This works by fetching your latest scrobbles from Last.fm and updating our cache accordingly.
"},{"location":"commands/whoknows/#note","title":"Note:","text":".update full to rebuild your playcount cache.Examples
.u
.update
.update full
If you want .fmbot to store more then just your top 4/5/6k artist/albums/tracks, check out .fmbot supporter!
Having issues with the bot not picking up what you're playing on Spotify? Check out the FAQ entry.
"},{"location":"commands/whoknows/#refreshmembers","title":".refreshmembers","text":"Refreshes the cache of which .fmbot users are in your server for server-wide commands.
"},{"location":"commands/whoknows/#note_1","title":"Note:","text":"Examples
.refreshmembers
.yt)","text":"Gets the Youtube link for the song you're currently listening to, or the one you're searching for.
Youtube embeds will be hidden if the user requesting does not have the 'Embed Links' permission.
Examples
.yt
.youtube
.yt Rick Astley Never Gonna Give You Up
.youtube Hi Stranger
Server settings can only be changed by admins, users with the 'Ban Members' permission or .fmbot admins.
"},{"location":"guildsettings/#configuration","title":".configuration","text":"Shows all server settings in an easy overview.
Use the dropdown to pick a setting that you want to change.
Examples
.config
.serversettings
Sets automatic emoji reactions for every .fm and featured command in your server.
To disable, simply use .serverreactions without any emojis.
Make sure the emojis you enable are on your server, or in a server that .fmbot is also in.
Max amount of emojis is 3. Please put a space between every emoji.
Examples
.serverreactions :PagChomp: :PensiveBlob:
.serverreactions \ud83d\ude00 \ud83d\ude2f \ud83e\udd75
.serverreactions \ud83d\ude00 \ud83d\ude2f :PensiveBlob:
.serverreactions
Enable/disable commands per channel, or completely disable the bot in a channel.
You can also force an fm mode for everyone in the channel.
Use the up/down options to pick the channel you want to change.
Examples
.togglecommand
You can enable/disable commands server-wide.
Examples
.toggleservercommand
This command allows you to change the .fmbot prefix on your server.
Note that you can always mention the bot, this will work regardless of prefix.
Examples
.prefix
@.fmbot prefix
Examples of commands when prefix is set to !
!fm
!chart
!whoknows
!topalbums
!prefix
You can change what users are able to gain crowns, configure other crown settings or completely disable crowns.
These settings can only be changed by admins, users with the 'Ban Members' permission or .fmbot admins.
"},{"location":"guildsettings/crownsettings/#crownthreshold","title":".crownthreshold","text":"Allows you set a minimum amount of plays required for someone to claim a crown.
The default value for this is 30.
Examples
.crownthreshold
Allows you to block users from gaining crowns if they have not been active in a certain amount of days.
A user is counted as active once they use .fmbot.
Examples
.crownactivitythreshold
Allows you to remove a crown and all crown history for a certain artist.
Examples
.killcrown deadmau5
.killcrown the beatles
Removes all crowns from your server.
Examples
.killallcrowns
.killallcrowns confirm
Removes all crowns from a specific user
Examples
.removeusercrowns 748900688129687642
.removeusercrowns lastfmsupport
Blocks a user from getting any crowns. They will still be visible in the whoknows output.
Examples
.crownblock 748900688129687642
.crownblock lastfmsupport
Unblocks a user and allows them to gain crowns again.
Examples
.unblock 748900688129687642
.unblock lastfmsupport
View all blocked members on your server.
Examples
.crownblockedmembers
Automatically adds crowns for your server. If you've done this before, it will update all automatically seeded crowns.
Crown seeding again only updates automatically seeded crowns, not manually claimed crowns.
Examples
.crownseeder
Removes all automatically seeded crowns from your server.
Examples
.killallseededcrowns
.killallseededcrowns confirm
Enables/disables all crowns for your server.
All mentions of crowns will be hidden and all crowns that exist will be removed.
Examples
.togglecrowns
You can use .fmbot webhooks to automatically post the featured music to your own channel.
To see more information about how featured works, click here.
"},{"location":"guildsettings/webhooks/#addwebhook","title":".addwebhook","text":"Adds a webhook to the channel or thread you're in.
Requires the bot to have the 'Manage Webhooks' permission.
To change the channel simply change it in the server integration settings.
To remove the webhook simply delete it from your server integrations.
Examples
.addwebhook
Sends a test message through the webhook you've setup in your server. You can use this to check if you've set everything up correctly.
Examples
.testwebhook
You can change what users appear in the whoknows commands and other commands that use all server members
These settings can only be changed by admins, users with the 'Ban Members' permission or .fmbot admins.
"},{"location":"guildsettings/whoknowsettings/#activitythreshold","title":".activitythreshold","text":"Allows you to filter users from commands that have not been active in a certain amount of days.
A user is counted as active once they use .fmbot.
Examples
.activitythreshold
Blocks a user from appearing in whoknows and from being in any server-wide statistic.
Examples
.block 748900688129687642
.block lastfmsupport
Unblocks a user from appearing in whoknows and from being in any server-wide statistic.
Also unblocks a user in case of any crown bans.
Examples
.unblock 748900688129687642
.unblock lastfmsupport
View all blocked members on your server.
Examples
.blockedmembers