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:

• mplayer (for MPlayer OS X Extended, MPlayerX or any variant)
• mpv (fork of Mplayer 2 and Mplayer)
• IINA (a player based on MPV)
• qtkitserver/Quicktime Player (for Quicktime Player if you playing only mp4 files)
• VLC (for Video Lan Player)
• Kodi (For Kodi, formerly XBMC, only supports local file detection unless you enable Kodi/Plex Theater JSON RPC Support in Advanced Preferences)
• Plex Theater (2.2.5 or later) via JSON-RPC API .
• Plex Media Server (includes all the Plex players, including the official app)
• Other Movie Players for the Mac that is also supported: SMPlayerX, VLCX, Squire, Niceplayer and Movist along with programs that stream to Airplay/Chromecast that use ffmpeg such as Beamer (2.2.10 or later).

For stream detection, only Crunchyroll, Daisuki, AnimeNewsNetwork, Viz, Animelab, Funimation, Netflix, Viewster, MyAnimeList, Vrv, Hidive, Amazon Prime Hidero (Anime Strike), and Plex.tv (locally and through plex.tv/web/app) 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
VRV.co	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

Scrobbler

• Start MAL Updater OS X at Startup: As the name suggests, if enabled, MAL Updater OS X will start when your Mac starts up.
• Confirm new titles before adding/Confirm before updating title - If any of these options are enabled, MAL Updater OS X will ask you if you want to add a new title or update an existing one before applying the update. This can be helpful if you want to check if the scrobbler is detecting the right title before applying it. If not, you can always correct it. Correcting will automatically confirm the update with the correct title.
• Start Scrobbling at Startup: As the name implies, it will start the scrobbler up automatically at program startup
• Cache Found Show IDs: (Enabled by default) MAL Updater OS X will cache the found show ID with the detected title to reduce the time needed to update your list. This program will only record the title MAL Updater OS X detects from the video player and won't save any file names. If you don't want this, just uncheck this.
• Use Kitsu Search API - MAL Updater OS X will search for the title using the Kitsu search API, which also provides alternate titles and such to improve recognition accuracy along with providing the MAL ID. Not enabled by default. (2.2.10 or later)
• Clear Search Cache: While it's unlikely, if you experiencing problems with the program updating the wrong title or any other issues, you can clear the search cache.
• Enable Auto Exceptions: Read more about it on this page

UI Settings

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

• Disable Yosemite Titlebar - If enabled, the old style window titlebar.
• Disable Vibrance - If enabled, Yosemite Vibrance transparency effect will be disabled.

Hotkeys

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.