このプロジェクトについて

SpotMenuは、SpotifyとApple Musicの再生コントロールをmacOSメニューバーに直接もたらします。SwiftとSwiftUIで構築されており、ワークフローを中断することなく音楽再生を管理するためのミニマルでネイティブなユーザー体験を提供します。 ### 主な機能 - **メニューバー統合**: 現在のアーティストと曲名をメニューバーに直接表示します。 - **再生コントロール**: ホバーオーバーレイで、アルバムアートとともに再生、一時停止、スキップ、トラックのいいね機能を提供します。 - **キーボードショートカット**: システムのどこからでも再生を制御できるグローバルホットキーが利用可能です。 - **トラックのいいね**: Spotify専用で、Spotify Web APIを使用してトラックをいいねまたはいいね解除できます。 - **コンパクトビュー**: フル表示とコンパクト表示を切り替えて、メニューバーのスペースを節約できます。 - **ライブ更新**: アプリはアクティブなメディア再生の変更と自動的に同期します。 - **マルチプレイヤーサポート**: アクティブなプレイヤーを自動検出するか、SpotifyとApple Musicを手動で選択できます。 ### インストール ユーザーは以下の方法でSpotMenuをインストールできます: - **直接ダウンロード**: GitHubリリースページから最新の署名済みおよび公証済みの`.app.zip`を取得します。Sparkleによる自動更新が含まれます。 - **Homebrew**: `brew install --cask spotmenu`コマンドで簡単にインストールできます。 - **ソースからビルド**: macOS 13+(Ventura)とXcode 15+が必要です。リポジトリをクローンし、`SpotMenu.xcodeproj`を開きます。 ### Spotify開発者設定 トラックのいいね機能を有効にするには、ユーザーはSpotify Developer Dashboardでアプリケーションを作成し、リダイレクトURIを`com.github.kmikiy.spotmenu://callback`に設定し、生成されたクライアントIDをSpotMenuの環境設定に入力する必要があります。 ### カスタマイズと環境設定 アプリケーションは、環境設定メニューの下で広範なカスタマイズオプションを提供します: - **音楽プレイヤー選択**: 自動検出、Spotify、またはApple Musicから選択します。 - **外観コントロール**: 再生オーバーレイのホバー色、前景色、ぼかし強度、不透明度を調整します。 - **メニューバーのビジュアル**: アーティスト名、曲名、アイコンの表示を切り替え、最大幅(40〜300pt)を調整します。 - **ショートカットマッピング**: 再生/一時停止、次の/前のトラック、いいね/いいね解除のグローバルホットキーを設定します。 ### 使用ガイド - **左クリック**: 再生パネルを表示または非表示にします。 - **右クリック**: コンテキストメニューを開きます。 - **パネルにホバー**: 詳細な再生コントロールを表示します。 SpotMenuはMITライセンスの下でリリースされています。