Script: spotify.py

Looks up meta information about spotify-URIs and posts back to channel.
Author: xt — Version: 0.10 — License: GPL-3.0-or-later
For WeeChat ≥ 0.3.0.
Tags: info, py2, py3
Added: 2009-09-26 — Updated: 2019-06-29

Download GitHub Repository

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
# -*- coding: utf-8 -*-
#
# Copyright (c) 2009 by xt <xt@bash.no>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
#

# If someone posts a spotify track URL in a configured channel
# this script will post back which track it is using spotify.url.fi service

# History:
# 2019-06-23, butlerx
#   version 0.10: Add support for spotify playlists
# 2017-09-30, butlerx
#   version 0.9: Add support for oauth keys being stored in secure data
# 2017-06-02, butlerx
#   version 0.8: add now required oauth support
# 2016-01-22, creadak
#   version 0.7: Updated for the new spotify API
# 2011-03-11, Sebastien Helleu <flashcode@flashtux.org>
#   version 0.6: get python 2.x binary for hook_process (fix problem when
#                python 3.x is default python version)
# 2010-01-12, xt
#   version 0.5: add option to use notice instead of message
# 2009-12-02, xt
#   version 0.4 small bugfix with some songs and popularity
# 2009-10-29, xt
#   version 0.3 use official spotify API, and add support for albums
# 2009-09-25, xt
#   version 0.2: use spotify.url.fi
# 2009-06-19, xt <xt@bash.no>
#     version 0.1: initial

import datetime
import re

import spotipy
import weechat as w
from spotipy.oauth2 import SpotifyClientCredentials

SCRIPT_NAME = "spotify"
SCRIPT_AUTHOR = "xt <xt@bash.no>"
SCRIPT_VERSION = "0.10"
SCRIPT_LICENSE = "GPL"
SCRIPT_DESC = "Look up spotify urls"

settings = {
    "buffers": "freenode.#mychan,",  # comma separated list of buffers
    "emit_notice": "off",  # on or off, use notice or msg
    "client_id": "client_id",
    "client_secret": "client_secret",
}

settings_help = {
    "buffers": "A comma separated list of buffers the script should check",
    "emit_notice": "If on, this script will use /notice, if off, it will use /msg to post info",
    "client_id": "required client id token go to https://developer.spotify.com/my-applications/#!/applications to generate your own",
    "client_secret": "required client secret token go to https://developer.spotify.com/my-applications/#!/applications to generate your own",
}


def parse_spotify_uri(uri):
    """
    parse spotify uri
    ---
    spotify:track:<id>
    spotify:artist:<id>
    spotify:album:<id>
    spotify:user:<user>:playlist:<id>
    """
    for regex in (
        re.compile(r"spotify:(?P<type>\w+):(?P<id>\w{22})"),
        re.compile(r"https?://open.spotify.com/(?P<type>\w+)/(?P<id>\w{22})"),
        re.compile(r"spotify:user:(?P<user>\w+):(?P<type>\w+):(?P<id>\w{22})"),
        re.compile(
            r"https?://open.spotify.com/user/(?P<user>\w+)/(?P<type>\w+)/(?P<id>\w{22})"
        ),
    ):
        results = regex.search(uri)
        if results is not None:
            yield results.groupdict()


def get_oauth(arg):
    """get oauth token from weechat conf or secure data"""
    token = w.config_get_plugin(arg)
    return (
        w.string_eval_expression(token, {}, {}, {})
        if token.startswith("${sec.data")
        else token
    )


def parse_track(data):
    """parse track data in to message"""
    name = data["name"]
    album = data["album"]["name"]
    artist = data["artists"][0]["name"]
    duration = str(datetime.timedelta(milliseconds=data["duration_ms"])).split(".")[0]
    popularity = data["popularity"]
    return "%s - %s / %s %s %d%%" % (artist, name, album, duration, popularity)


def parse_artist(data):
    """parse artist data in to message"""
    return "%s - %s followers" % (data["name"], data["followers"]["total"])


def parse_album(data):
    """parse album data in to message"""
    name = data["name"]
    artist = data["artists"][0]["name"]
    tracks = data["tracks"]["total"]
    released = data["release_date"].split("-")[0]
    length = 0
    for track in data["tracks"]["items"]:
        length += track["duration_ms"]
    duration = str(datetime.timedelta(milliseconds=length)).split(".")[0]
    return "%s - %s (%s) - %d tracks (%s)" % (artist, name, released, tracks, duration)


def parse_playlist(data):
    """parse playlist data in to message"""
    return "%s by %s - %s tracks - %s followers" % (
        data["name"],
        data["owner"]["display_name"],
        data["tracks"]["total"],
        data["followers"]["total"],
    )


def search_spotify(spotify, uri):
    """search spotify based on a uri"""
    for results in parse_spotify_uri(uri):
        if results["type"] == "album":
            yield parse_album(spotify.album(results["id"]))
        elif results["type"] == "track":
            yield parse_track(spotify.track(results["id"]))
        elif results["type"] == "artist":
            yield parse_artist(spotify.artist(results["id"]))
        elif "user" in results and results["type"] == "playlist":
            yield parse_playlist(spotify.user_playlist(results["user"], results["id"]))


def spotify_print_cb(data, buffer, time, tags, displayed, highlight, prefix, message):
    buffer_name = w.buffer_get_string(buffer, "name")
    server, channel = buffer_name.split(".")
    command = "notice" if w.config_get_plugin("emit_notice") == "on" else "msg"

    if buffer_name.lower() not in [
        buffer.lower() for buffer in w.config_get_plugin("buffers").split(",")
    ]:
        return w.WEECHAT_RC_OK

    spotify = spotipy.Spotify(
        client_credentials_manager=SpotifyClientCredentials(
            get_oauth("client_id"), get_oauth("client_secret")
        )
    )
    for reply in search_spotify(spotify, message):
        w.command("", "/%s -server %s %s %s" % (command, server, channel, reply))
    return w.WEECHAT_RC_OK


if __name__ == "__main__":
    if w.register(
        SCRIPT_NAME, SCRIPT_AUTHOR, SCRIPT_VERSION, SCRIPT_LICENSE, SCRIPT_DESC, "", ""
    ):
        # Set default settings
        for option, default in settings.items():
            if not w.config_is_set_plugin(option):
                w.config_set_plugin(option, default)

        # Set help text
        for option, description in settings_help.items():
            w.config_set_desc_plugin(option, description)

        w.hook_print("", "", "spotify", 1, "spotify_print_cb", "")