add importing

docs/importing.md

@@ -0,0 +1,113 @@
+# Importing your music history
+
+By default, .fmbot uses your Last.fm for all your music data. We now also offer a way to import your music history from other sources and allow you to combine that with your Last.fm stats in various ways.
+
+Importing is currently in beta. You might experience bugs, data inaccuracies or other issues.
+
+!!! info ""
+    Importing is only available for .fmbot supporters. Dont have supporter yet? <a href="/supporter/">Get it here.</a>
+
+---
+
+### /import manage
+
+Allows you to imanage your imports and your import settings.
+
+You can pick between the following modes:
+
+**Last.fm**
+
+- Use only your Last.fm for stats and ignore imports
+
+**Full Spotify, then Last.fm**
+
+- Uses your full Spotify history and adds Last.fm afterwards
+- Recommended if you have imported Spotify on Last.fm before
+- Plays from other music apps you scrobbled to Last.fm will not be included
+
+**Spotify until full Last.fm**
+
+- Uses your Spotify history up until the point you started scrobbling on Last.fm
+- Do not use this if you have imported on Last.fm before
+- Best if you have scrobbles on Last.fm from sources other then Spotify
+
+To delete your imports from .fmbot, switch to the Last.fm option and use the provided button.
+
+!!! note "Examples"
+    `/import manage`
+
+---
+
+### /import Spotify
+
+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 `endsong.json` files from the 'Extended Streaming History' package.
+
+
+!!! note "Examples"
+    `/import Spotify`
+
+---
+
+#### Requesting your files from Spotify
+
+1. Go to your <a href="https://www.spotify.com/us/account/privacy/" target="_blank">**Spotify privacy settings**</a>
+2. Scroll down to "Download your data"
+3. Select **Extended streaming history**
+4. De-select the other options
+5. Press request data
+6. Confirm your data request through your email
+7. Wait up to 30 days for Spotify to deliver your files
+
+#### Importing your data into .fmbot
+1. Download the file Spotify provided
+2. Extract the .zip file so you have multiple endsong_x.json files ready
+3. Use the `/import Spotify` slash command and attach each file through the options
+
+#### Notes
+- We filter out duplicates, so don't worry about submitting the same file twice
+- Spotify files includes plays that you skipped quickly, we filter those out as well
+
+---
+
+## Frequently asked
+
+#### Why would I use importing?
+
+Importing 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.
+
+#### Are platforms other then Spotify also supported?
+
+At the moment we only support Spotify.
+
+- Apple Music doesn't provide any artist names with their exports. We're exploring ways to still allow for importing, but it will probably not be 100% perfect.
+- Stats.fm does not support users to request their own data yet unless you physically come to their office. They're working on making this an easier process.
+
+Want a different platform to be supported? Open a help thread in [our server](discord.gg/fmbot). 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.
+
+#### How long does it take before Spotify sends my data?
+
+Spotify sends their files out in waves. For the extended streaming history package they usually do this once every 3 weeks.
+
+#### What data from my imports do you store?
+
+We only store the following information:
+
+- Artist name
+- Album name
+- Track name
+- Time played
+- Length listened
+
+#### Can I change or delete my imports?
+
+See the [/import manage](#import-manage) command.

mkdocs.yml

@@ -73,6 +73,7 @@ nav:
     - 'Crowns': 'guildsettings/crownsettings.md'
     - 'Webhooks': 'guildsettings/webhooks.md'
   - 'Music bot scrobbling': 'botscrobbling.md'
+  - 'Spotify importing': 'importing.md'
   - 'Development': 'setup.md'
   - 'Privacy': 'privacy.md'
   - 'Terms of Use': 'terms.md'