Skip to content

defvs/monsterutilities

Repository files navigation

icon MonsterUtilities Discord Latest Release GitHub last commit

Browse, stream and download Monstercat Songs, powered by the Monstercat API and MCatalog.

The application has been used by many people without major problems. But it will probably stay in "beta" because the main developers are not as active anymore.
We are however still available for questions in the Discord or via GitHub issues and welcome new contributors!

Getting started

Packaged portable versions as well as OS-specific installers are available from GitHub releases.
For packages without a bundled JRE, the application requires Java 8 by Oracle.

Make sure to read the initial in-app guide and watch out for tooltips.

Authentication

For downloading and listening to early access, insert a valid cid at the bottom of the Downloader.
Obtain it though the process below or simply supply your credentials to the login form in the application.

  1. [Sign in on monstercat.com][Monstercat-signin] and ensure that you have a valid Monstercat Gold subscription
  2. Find a cookie for www.monstercat.com in your browser Chromium-based browsers: chrome://settings/cookies/detail?site=www.monstercat.com
    Firefox: Go to https://www.monstercat.com/, open dev tools (Ctrl+Shift+I), go to Storage > Cookies > https://connect.monstercat.com
  3. Find the content of cid
  4. Copy that string into the cid Text field at the bottom of the Downloader

The cid can be used to obtain full access to your account, so treat it carefully. The application never sends it anywhere but Monstercat servers.
Please note though that it is persisted on your computer using the Java Preferences API for your convenience.

Caching & Offline usage

Sometimes the cache runs into issues which may cause problems in the Downloader. In that case use the "Clear cache & Restart" button in the settings to reset the cache.

Upon starting the application for the first time, it will fetch and cache all Releases as well as Sheets (Catalog/Genres). This might take some time depending on your internet connection. On subsequent use it will prefer to fetch incrementally, reducing the load on your connection as well as Monstercat's Servers.
Once fetched, Songs can be browsed offline but not played or downloaded.

Cache and logs are stored in a temporary directory, depending on your operating system:

  • Windows: C:\Users\<username>\AppData\Local\Temp\monsterutilities - can be changed by editing the java.io.tmpdir system property
  • Unix: /var/tmp/monsterutilities, or under /tmp if /var/tmp does not exist

Screenshots

Catalog

The Catalog provides an overview of all Tracks ever released on the label with extensive filtering possibilities.

Tip: You can customize which columns to show by clicking the + in the top right of the table.

Catalog Catalog filtering

Streaming

There is a player on the top that can stream any Monstercat track, just like the website. Double-click on any piece in the Catalog or Downloader to load it into the Player!

Player

Downloader

If you have Monstercat Gold you can bulk download everything according to your preferences!

Downloader Downloader

Customization

The application has various color schemes and configuration options.

Settings

Credits

@xerus2000 founded the project and established most of its features. He still technically owns it, but has mostly moved on to other projects.
@defvs is currently the maintainer.

We thank install4j for providing a free license to build the installers.