RubinLabs26/ISpotify

iSpotify – クイック概要

概要 – iSpotify は、Windows または Linux で音楽を検索し、MP3 ファイルとしてダウンロードし、ローカルで再生できる無料のオープンソースデスクトップクライアントです。すべての操作はお使いのコンピューター上で行われます。中央の iSpotify アカウント、サーバー、分析、テレメトリはありません。

主な機能

機能	提供内容
検索と発見	曲やプレイリストを（YouTube 経由で）クエリし、結果を閲覧できます。複数のアイテムを一度に選択して一括ダウンロードできます。
ダウンロードマネージャー	MP3 ダウンロードをキューに入れ、速度/予想時間を表示し、失敗時に再試行し、再起動後も保持します。
ローカルライブラリ	ダウンロードしたファイルは OS 固有のユーザーデータフォルダーに保存されます。並べ替え、お気に入り登録、プレイリストへの整理が可能で、オフライン再生に対応しています。
再生	前へ/次へ、シーク、音量調整、ヘッドフォンが抜かれたときの自動一時停止を備えたシンプルなオーディオプレーヤー。
プライバシー優先	認証情報（YouTube クッキー、Discord トークン）は OS のキーリングに保存されます。テレメトリがマシンから送信されることはありません。
Discord 統合（オプション）	Discord アカウントをリンクすると、カバーアートとトラック時間付きの「Listening to iSpotify」ステータスを公開します。
クロスプラットフォーム UI	PySide6（Qt for Python）で構築されているため、同じインターフェースが Windows と Linux で動作します。
インストールオプション	Windows インストーラー、ポータブル exe、Debian/Ubuntu .deb、汎用 Linux ポータブルバイナリ、または署名付きリポジトリを追加して aria2 を取得し、高速で再開可能なダウンロードを実現するワンラインインストールスクリプト。

内部の仕組み

• yt‑dlp は YouTube の検索、ビデオ URL の解決、オーディオストリームの抽出に使用されます。
• FFmpeg（またはバンドルされている imageio‑ffmpeg）がストリームを高品質の MP3 に変換します。
• Aria2（Linux インストーラーでインストール）が実際のファイルダウンロードを再開サポート付きで処理します。
• Keyring は、クッキーや Discord トークンを OS の保管庫に安全に保存します。
• GUI は、これらのツールを調整し、おなじみのミュージックプレーヤーレイアウトを提示する薄い Qt レイヤーです。

はじめに

1. ダウンロード テーブルから適切なパッケージをダウンロードします（例：Windows 用の ISpotify-Setup-x86_64.exe または Linux インストールスクリプト）。
2. インストーラーまたはポータブルバイナリを実行します。アプリはライブラリ用のユーザーデータフォルダーを作成します。
3. アプリを開き、トラックを検索してダウンロードボタンをクリックします。バックグラウンドキューが完了すると、ファイルがライブラリに表示されます。
4. （オプション）設定 → Discord で Discord アカウントをリンクして、再生中の曲をブロードキャストします。

こんな方におすすめ – Spotify のストリーミングアプリに代わる自己ホスト型の代替を求める音楽愛好家、Python ベースのデスクトップツールを好む開発者、またはリスニングデータを完全にプライベートに保ちたい人。

貢献 – プロジェクトは標準の Python 仮想環境ワークフロー（python -m venv .venv && pip install -r requirements.txt）を使用しています。プルリクエストによる貢献を歓迎します。ガイドラインについては CONTRIBUTING.md を参照してください。

---

上記の情報はすべてリポジトリの README から直接取得しています。