xeruf / monsterutilities

Browse, stream and download Monstercat Songs
GNU General Public License v3.0
31 stars 2 forks source link

Maintainership handed over to defvs, please use his fork instead!

icon MonsterUtilities Discord Build Status

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 connect.sid 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 connect.monstercat.com in your browser
Chromium-based browsers: chrome://settings/cookies/detail?site=connect.monstercat.com
Firefox: Go to https://connect.monstercat.com/ (ignore any errors), open dev tools (Ctrl+Shift+I), go to Storage > Cookies > https://connect.monstercat.com 3) Find the content of connect.sid - a string starting with s%3A and around 90 characters in length 4) Copy that string into the connect.sid Textfield at the bottom of the Downloader

The connect.sid 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:

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 created the project and established most basic features. He has moved on to other projects and handed over ownership to defvs.

@defvs is currently the main maintainer.

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