How‐to: create the access and refresh token - ReneNulschDE/mbapi2020 GitHub Wiki

File is work in progress...

MacOS

• Minimum MacOS version: 13.7
• Download the latest macos package
• Install the package
• Run the app "MBAPI2020 Token Helper"
  1. Click "Start Authentication", a MacOS warning will appear - click on continue
  2. Safari will start and ask for your MB credentials
  3. At the end of the process, the Tokens are visible in the app.

Windows (10 or higher)

• Download and install the .NET Runtime 8

• Download the latest package for your processor architecture

• Unzip the file

• Start mb-token-requester.exe

  Note: Do not start it from a network share as this will prevent the needed inter-process communication

  1. The app will open a standard browser window
  2. Enter you're MB credentials and allow the URlhandler process start
  3. At the end of the process, the Tokens are visible in the app.

Linux-x64

Most desktop distributions like CentOS Stream, Debian, Fedora, Ubuntu, and derivatives) only

Step 4 and 5 can be different in your distro. Tested with Ubuntu 24.10

1. Download and install the .NET Runtime 8
2. Download the latest package ()
3. Modify the mb-shortcut-handler.desktop file and set the correct file location in the line "Exec..."
4. Copy the file mb-shortcut-handler.desktop to ~/.local/share/applications/
5. Run update-desktop-database -v ~/.local/share/applications to update the mimetype-cache
6. Make the program executable with chmod +x mb-token-requester
7. Start mb-token-requester
8. The app will open a standard browser window
9. Enter you're MB credentials and allow the URlhandler process start
10. At the end of the process, the Tokens are visible in the app.