Getting Started - Atelier-Shiori/malupdaterosx-cocoa Wiki

You have downloaded MAL Updater OS X and you don't know what to do. Here are some simple steps to get it working.

Since the data model changes occasionally, it's no longer possible to go back to the older version as the database structure will be upgraded when you update. Attempting to launch a message will show an error stating that the persistent storage cannot be loaded. If you want to revert, you should backup the database that is contained in ~/Library/Application Support/MAL Updater OS X. If you don't mind losing your Scrobble history, just remove that folder.

The API functions uses HTTPS by default, meaning that any Unofficial MAL API requests will be encrypted.

Follow @maluosxdev on Twitter for the latest development updates.

1. Set your User name and Password

MAL Updater OS X will prompt you to open the Preference Window and open the Login preferences if there is no account saved. If you choose to do so, it will take you to the Login Preferences.

You should see a notification stating that you should save your account information first. To do this, click the Fox icon on the Menu bar, Click Preferences and then click Login. Then type your MyAnimeList Username and Password and then click Save Login.

MAL Updater OS X 2.5 or later

The new Official MAL API now uses OAuth for authentication. To start the Authorization process, click the authorize button. A web view will appear prompting to login and approve the App. Afterwards, MAL Updater OS X is ready to use.

2. Start the Scrobbler

To do this, click on the Fox icon and then click "Start Scrobbling." The program will start checking for playing files every 5 minutes and if a video file is playing, it will do its magic. Once updated, if the same video file is playing or an earlier episode, it will not update the list.

Also, you can scrobble on demand by choosing the Update Now option on the menu

Here are the supported players:

For stream detection, only Crunchyroll, Daisuki, AnimeNewsNetwork, Viz, Animelab, Funimation, Netflix, Viewster, MyAnimeList, Vrv, Hidive, Amazon Prime Hidero (Anime Strike), and (locally and through is supported under Safari (including Webkit), OmniWeb, Roccat and Chrome. If you want your favorite streaming site supported, add a issue and include the URL and exact page title for the show you are watching on that site and I will add it.

Note, for Amazon Prime Video or Viewster detection under macOS Sierra or later, you need to enable "Allow JavaScript from Apple Events." You can enable this by going to Preferences > Advanced and enable the "Show Develop menu in Menu Bar" option. The option should appear as shown below.

Below is a streaming site compatibility list.

Site Safari (including Webkit) Chrome (including Chromium) Omniweb Roccat
Crunchyroll Y Y Y Y
Anilab Y Y Y Y
Anime News Network Y Y Y Y
Viz Y Y Y Y
Funimation Y Y Y Y
MyAnimeList Y Y Y Y
Wakanim Y Y Y Y
Netflix Y Y Y Y
Viewster Y (1) Y N N
Plex (2) Y Y Y Y Y Y Y Y
Hidive Y Y Y Y
Amazon/Anime Strike (3) Y (1) Y N N
Yahoo View Y Y Y Y
  1. Recent versions of Safari has Javascript execution disabled for Apple Events. You need to enable this in the "Developer" Menu. This option can be enabled in Preferences in the Advanced options
  2. Plex Stream detection do not support Plex agents. This is because it obscures the title and episode number. You must set the library to use Personal Media agent so the scrobbler can recognize the title properly.
  3. HTML5 player is only supported for detection. Silverlight player is not supported. The HTML5 Amazon player in Safari will only work on 2012 or later models or on some 2011 models with macOS 10.12.1 Sierra and the latest version of Safari. If you have a Mac earlier than 2012, use Google Chrome instead.

Hint: You can have scrobbling start automatically by enabling the "Start Scrobbling at Startup" option in General Preferences.

Other Things

Once a title is updated, you can update the status or rating by clicking the Edit Status button on the toolbar in the Status Window or going to Last Scrobbled > Edit Status from the menu.

Other Preference Options


UI Settings

If changed, MAL Updater OS X must be restarted to take effect.


This allows you to specify four different hotkeys for common functions such as toggling automatic scrobbling, on demand updating, confirming a title and showing the status window.