Spoton - Spotify Now Playing for mIRC

Spoton running on mIRC 7.67

Requirements

• Supported Operating System: Windows 10 and 11.
• Visual C++ Redistributable 2015-2022 (x86)
• mIRC version: 7.61 - 7.76
• Spotify Version: 1.1.91 - 1.2.33
• HDD/SSD Space: 18,5 KB.

Installation

1. Download spoton_vx.x.x.zip zip archive of Spoton in Assets in the Releases section.
2. If you don't have Visual C++ Redistributable 2015-2022 (x86) installed, download from here: https://aka.ms/vs/17/release/vc_redist.x86.exe.
3. Right Click on the archive which is named spoton_vx.x.x.zip, extract the archive.
   • Optional - verify the hash:
     1. Open up powershell and cd to spoton_vx.x.x folder.
     2. Run this command Get-FileHash spoton.dll.
     3. Then look if the sha256 checksum is correct from Releases.
     4. If it's correct you should be fine.
4. Open mIRC.
5. Paste //noop $sfile($mircdir) to mIRC and press enter. You will see a file picker dialog.
6. Navigate to the folder where you extracted the archive and select spoton.dll.

Usage

Use: $dll(pathtospoton\spoton.dll,command,)

Command	Description
version	Version of the plugin
creator	Credits of the plugin creator
status	0 = Spotify not running, 1 = Spotify paused, 2 = Spotify playing an advertisement, 3 = Spotify playing a track.
song	The entire window title, usually "artist - song title"
artist	If the title contains a dash ("-"), returns the left side, usually the artist. Otherwise, nothing.
title	If the title contains a dash ("-"), returns the right side, usually the song title. Otherwise, nothing.

Controlling Spotify from mIRC

Use: /dll pathtospoton\spoton.dll control command

Command	Description
playpause	Plays or Pauses the track.
play	Plays the track.
pause	Pauses the track.
next	Play next track.
previous	Play previous track.
forward	Forward the current track.
rewind	Rewind the current track.
show	Open the Spotify Window.

Show current song as status

Please ensure Spoton alias snp is not triggered by any other scripts.

To add the script:

1. In mIRC, click on Scripts Editor or ALT + R
2. Select Remote.
3. Click on File > New.
4. Copy the code below and paste inside the new Script file
5. Save. Now you can use /snp in any channel or private messages.

alias snp {
  var %status $dll(spoton.dll,status,)
  if (%status == 3) say Spotify » $dll(spoton.dll,song,)
  else echo -ag Spotify is $replace(%status,0,Not Running,1,Paused,2,Playing Advertisement)
}

Add playback buttons to interface

This script adds playback buttons to your chat interface.

1. Download and extract the archive "Spoton mIRC Addon.zip"
2. Copy the contents and paste to mIRC. Ensure you have spoton.dll there as well (from releases).
3. Type /load -rs spoton.mrc in mIRC. The script will return that it is loaded.

Removal:

1. Type /unload -rs spoton.mrc in mIRC
2. Remove spoton.dll and the folder img.

Frequently Asked Questions

Q: I can't find vx.x.x on download section, what do I do wrong?

A: x.x.x stands for the version number, look for that in releases.

Q: How does Spoton work?

A: It works by reading Windows API calls from Spotify to detect artist - title, plus using Spotify's media controls.

Q: Does Spoton require a Spotify API key or internet connection?

A: No. Spoton does not use Spotify API keys and it works offline.

Q: I am getting an error: $dll: unable to open 'C:\Users\USERNAME\AppData\Roaming\mIRC\pathtospoton\spoton.dll

A: This can show up for 2 reasons:

1. You have put the DLL file in the wrong location.
2. You need to install Visual C++ Redistributable 2015-2022 (x86)

Q: I am getting an error: /echo: insufficient parameters or Artist - ??? ?????? ??? or nothing.

A: You are using an outdated version of Spoton. Please update.

Credits

I have learned more about making mIRC reading and writing for DLL-file from Wikichip
Thanks to @Westor for helping me out with fixing vulnerables and other things in the "Spoton mIRC Addon".
Thanks to @moobsmc for Stop Control for Spotify.
Thanks to @Madis0 for helping me with the readme and other things.