Skip to content
This repository has been archived by the owner on Nov 27, 2024. It is now read-only.

turbosmurfen/spoton

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Caution

Due to lack of time I dont update the code and script anymore, people who may use it should do it with caution.

Github All Releases CodeQL

Spoton - Spotify Now Playing for mIRC

Spoton on mIRC 7.67

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.77
  • Spotify Version: 1.1.91 - 1.2.43
  • HDD/SSD Space: 17,5 KB

Note

mIRC and Spotify version ABOVE is not going to be updated frequently.

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. In mIRC, write //run $mircdir, then move spoton.dll from the downloaded archive to the opened folder.

Usage

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

Command Description
version Version of the plugin
creator Credits of the plugin creator
status 0 - Spotify is not running, 1 - Spotify is paused, 2 - Spotify is playing an advertisement, 3 - Spotify is 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 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 the mIRC folder. 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 using the 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\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.