프로젝트 소개

SpotMenu은 Spotify와 Apple Music 재생 컨트롤을 macOS 메뉴 바에 직접 제공합니다. Swift와 SwiftUI로 구축되어 워크플로우를 방해하지 않고 음악 재생을 관리할 수 있는 미니멀하고 네이티브한 사용자 경험을 제공합니다. ### 주요 기능 - **메뉴 바 통합**: 현재 아티스트와 노래 제목을 메뉴 바에 직접 표시합니다. - **재생 컨트롤**: 호버 오버레이에서 앨범 아트와 함께 재생, 일시정지, 건너뛰기, 트랙 좋아요 기능을 제공합니다. - **키보드 단축키**: 시스템 어디서나 재생을 제어할 수 있는 전역 핫키를 지원합니다. - **트랙 좋아요**: Spotify 전용으로 Spotify Web API를 사용하여 트랙을 좋아요 또는 좋아요 취소할 수 있습니다. - **컴팩트 뷰**: 전체 및 컴팩트 표시 모드 간 전환으로 메뉴 바 공간을 절약합니다. - **실시간 업데이트**: 활성 미디어 재생 변경 사항을 자동으로 동기화합니다. - **멀티 플레이어 지원**: 활성 플레이어를 자동 감지하거나 Spotify와 Apple Music 간 수동 선택을 허용합니다. ### 설치 사용자는 여러 방법으로 SpotMenu을 설치할 수 있습니다: - **직접 다운로드**: GitHub Releases 페이지에서 최신 서명 및 공증된 `.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`으로 설정한 후, 생성된 Client ID를 SpotMenu의 환경설정에 입력해야 합니다. ### 사용자 정의 및 환경설정 이 애플리케이션은 환경설정 메뉴에서 광범위한 사용자 정의 옵션을 제공합니다: - **음악 플레이어 선택**: 자동 감지, Spotify 또는 Apple Music 중 선택합니다. - **외관 컨트롤**: 재생 오버레이의 호버 틴트 색상, 전경 색상, 블러 강도 및 불투명도를 조정합니다. - **메뉴 바 시각 요소**: 아티스트 이름, 노래 제목, 아이콘 표시 여부를 전환하고 최대 너비(40–300pt)를 조정합니다. - **단축키 매핑**: 재생/일시정지, 다음/이전 트랙, 좋아요/좋아요 취소에 대한 전역 핫키를 설정합니다. ### 사용 가이드 - **왼쪽 클릭**: 재생 패널을 표시하거나 숨깁니다. - **오른쪽 클릭**: 컨텍스트 메뉴를 엽니다. - **패널에 호버**: 상세 재생 컨트롤을 표시합니다. SpotMenu은 MIT 라이선스로 배포됩니다.