【ITニュース解説】Set up spin-that-dice in 10 minutes, no Spotify app needed to start
2026年11月02日に「Dev.to」が公開したITニュース「Set up spin-that-dice in 10 minutes, no Spotify app needed to start」について初心者にもわかりやすく解説しています。
ITニュース概要
音楽パーティーサイコロ「spin-that-dice」は、簡単にセットアップできるアプリ。Spotifyアプリ不要で、初期から305曲をランダム再生できる。Spotify Premium連携で43カテゴリから選曲も可能。NavidromeやJellyfinとの連携もサポートしており、手軽に音楽体験を始められる。セットアップガイドも充実している。
ITニュース解説
「spin-that-dice」は、音楽体験をより楽しく、そして手軽にするために設計されたユニークなアプリケーションである。このツールは、まるでパーティーでサイコロを振るかのように、タップ一つで事前に定義された43種類のカテゴリーの中からランダムに選ばれた楽曲を再生する機能を提供する。新しい音楽を発見したい時や、友人と集まって盛り上がりたい時に、非常に直感的な方法で音楽を楽しめるのが特徴である。
このアプリケーションの大きな魅力は、その導入の手軽さにある。わずか10分程度で基本的なセットアップを完了し、すぐに利用を開始できると謳われている。開発者は、毎週GitHub上で最新の環境でセットアップガイドが正しく動作するかを自動的に確認しているため、もし何らかの理由で手順が機能しなくなった場合でも、ユーザーが問題に直面する前に開発者がそれを把握し、修正を加える体制が整っている。これにより、セットアップの過程で初心者でも安心して進めることができる。
特に注目すべき点は、初期段階ではSpotifyの公式アプリケーションをインストールしていなくても、「spin-that-dice」を動作させられることである。これは、アプリケーションのプログラム自体に、305曲分の初期音楽データが10種類のカテゴリーにわたって同梱されているためである。これにより、ユーザーはプログラムを準備しさえすれば、すぐにサイコロを振って音楽再生を体験できる。具体的な開始手順は非常にシンプルである。まず、コンピューターのコマンドラインインターフェース(ターミナルやコマンドプロンプト)を開き、git clone https://github.com/casareanderson/spin-that-diceというコマンドを実行して、「spin-that-dice」のプログラム一式を自分のコンピューターにダウンロードする。ダウンロードが完了したら、cd spin-that-diceと入力して、新しく作成されたプログラムのディレクトリへ移動する。次に、Pythonのパッケージ管理ツールであるpipを利用して、プログラムの動作に必要な「requests」というライブラリをインストールする。これはpython3 -m pip install requestsというコマンドで行われる。そして最後に、python3 spin.pyと入力して実行すると、「spin-that-dice」のサーバーが起動する。
サーバーが正常に起動すると、ウェブブラウザから127.0.0.1:8770というアドレスにアクセスできるようになる。このアドレスをブラウザのアドレスバーに入力して開くと、「spin-that-dice」のユーザーインターフェースが表示され、サイコロをタップすることで、同梱されている初期の305曲の中からランダムに選ばれた曲が再生される。この一連の初期セットアップは、サーバーが正しく起動すること、HTTP通信を通じて初期の曲リストから選曲されること、そして未定義のカテゴリーや不正なパスへのアクセスが拒否されること、さらにアプリケーションの静的なウェブサイト部分が正しく構築されることを確認する、一連のテストとしての役割も果たしている。
ただし、ここで一つ重要な注意点がある。再生された楽曲を実際にスピーカーから聞くためには、Spotify Premiumの有料アカウントが必須となる点である。以前はSpotifyが提供していた30秒の楽曲プレビュー機能は、2024年をもって廃止されたため、無料アカウントでは楽曲の試聴ができない。
初期状態では10種類のカテゴリーしか利用できないが、Spotifyの開発者向けプラットフォームを利用することで、「spin-that-dice」の機能をさらに拡張し、残りの33カテゴリーも使えるようにすることが可能である。そのためには、まずSpotifyのウェブサイトで無料で開発者アカウントを作成し、自分のアプリケーションを登録して発行される「クライアントID」と「クライアントシークレット」という二つの認証情報を取得する必要がある。これらの情報を、「spin-that-dice」の環境設定ファイルであるspin.envというファイルに貼り付け、アプリケーションを再起動すると、SpotifyのAPIを通じて残りのカテゴリーの曲情報が自動的に補充され始める。この補充プロセスはバックグラウンドで実行され、最も曲数が少ないカテゴリーから優先的に情報が取得されていく。
SpotifyのAPIを利用する際には、いくつかの制限と注意点がある。SpotifyはAPIへのアクセス頻度を制限しており、一般的には1時間あたり最大60回のリクエストという制限が設けられている。もしこの制限を超えてAPIを呼び出そうとすると、「429 Too Many Requests」というエラーコードが返され、一時的にAPIへのアクセスが制限される。このエラーを受け取った際、APIは再試行までの推奨待機時間を「Retry-After」という情報で示す。もしこの待機期間中に何度もアクセスを試みると、アクセス制限の期間がさらに延長され、最悪の場合24時間近くAPIにアクセスできなくなることもある。しかし、「spin.py」というプログラムは、このような状況を考慮して設計されており、「Retry-After」の情報を受け取ると、指定された時間が経過するまでAPIへの呼び出しを自動的に停止する。したがって、制限中にプログラムを繰り返し再起動するような行動は避けるべきである。
「spin-that-dice」はSpotifyに限定されず、他の音楽サービスと連携させる柔軟性も持っている。「Navidrome」や「Jellyfin」といった、ユーザー自身がサーバーを構築して運用する(自己ホスト型)メディアサーバーサービスを音楽の提供元として利用することも可能である。これはSPIN_PROVIDERという環境変数を設定することで実現でき、Spotifyのアカウントを持たないユーザーでも、自分の持っている音楽ライブラリを使って「spin-that-dice」を楽しむことができる。
さらに、このアプリケーションは単なる一時的な利用に留まらない、より高度な運用方法も提供されている。公式ドキュメントであるdocs/SETUP.mdには、アプリケーションをオペレーティングシステム(OS)のサービスとして常にバックグラウンドで実行する方法や、タブレットのホーム画面にショートカットアイコンを追加して手軽にアクセスできるようにする方法、さらにはアプリケーションの静的なコピーをウェブサーバーに公開する方法など、詳細なガイドが記載されている。これにより、ユーザーは自分の用途や環境に合わせて「spin-that-dice」を自由にカスタマイズし、さらに活用することが可能となる。
開発者は常に、より魅力的で改善された音楽カテゴリーのアイデアを歓迎している。このプロジェクトは、システムエンジニアを目指す初心者にとって、実際に動作するアプリケーションをセットアップし、その仕組みを理解するための良い学習機会であると同時に、音楽を通じてコミュニティに参加できる場も提供していると言える。