Giter Site home page Giter Site logo

spoton's Introduction

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.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.

spoton's People

Contributors

madis0 avatar turbosmurfen avatar westor7 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

spoton's Issues

[BUG] UTF8/Unicode Not working correctly

Describe the bug
Unicode characters are displayed as ???

To Reproduce
Open Spotify
Play a random track from Rauf & Faik
Example (web url): https://open.spotify.com/track/28ANlEDKpDwmpESwlbNMAV?si=aa2d010ef77b47ed

Run the plugin: //echo -a $dll(spoton.dll,song,)
Output: Rauf & Faik - ??? ????? ???????

Expected behavior
Rauf & Faik - что такое любовь?

Screenshots
image

Desktop (please complete the following information):

  • OS: Windows
  • Version: 10
  • Edition: Enterprise
  • Architecture: 64bit
  • mIRC: 7.61

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.