mcfm
v1.0.6
Published
Monstercat FM Tools is a command line utility for getting informationfrom the Monstercat stream at http://twitch.tv/monstercat.
Downloads
10
Readme
Monstercat FM Tools
Monstercat FM Tools is a command line utility for getting informationfrom the Monstercat stream at http://twitch.tv/monstercat.
Availiable on npm: mcfm
By parsing monstercat
's messages on the stream, it can recover some information about the currently playing song.
It currently can
- Save current artist and song name to a file (great for using together with OBS or other streaming programs)
- Download the current songs album art from Spotify
Getting started
mcfm-tools is built with node / iojs, so a working installation of node or iojs is required. Nodejs can easily be installed from nodejs.org. When nodejs is installed, make sure you can use it from the command line and you are ready to install mcfm
- Open a terminal and type
npm install -g mcfm
to install mcfm globally on your system - type
mcfm
to make sure mcfm was installed properly - Get an API key for using the Twitch chat through IRC, the easiest way is to use http://twitchapps.com/tmi/.
- type
mcfm -u Ineentho -o oauth:7j8vge4o0l1js2m1z6gb936cpwhmm1
, replacingIneentho
with your Twitch username andoauth:7j...
with the key you got from twitchapps. - Now, each time the song is changed it should be printed to your terminal. If that's working, you can continue to examples section to see how to save this information to a file
Examples
Keep in mind the oauth key you generated earlier will be required with all of these commands.
Save current song name to a file called current-song.txt
This is probably the easiest way to display the current song in most streaming programs (including OBS)
mcfm -u user -o oauthkey -f current-song.txt
You will now have a file called current-song.txt containging the current song like "Breakdown - Noisestorm" for example.
Customize the output format
If you aren't happy with default "Song - Artist", you can easily change it with the -F
parameter.
mcfm -u user -o oauthkey -f current-song.txt -F "{song} by {artist}
Allowed parameters: Song: {song}, Artist: {artist}, Spotify url: {spotify}, Album art url: {art} (if --arts is specified)
Save the album art to a file
You can store the album art from spotify into a png file. This can be combined with any of the previous examples, or used as in this example.
mcfm -u user -o oauthkey -A albumart.png
Usage
mcfm -h
will print all availiable options.