OpenDeezer

소개

OpenDeezer는 Deezer 라이브러리를 탐색하고 스트리밍할 수 있는 네이티브 터미널 클라이언트입니다. TUI(텍스트 기반 사용자 인터페이스)와 네이티브 크로스플랫폼 GUI를 모두 제공하여 Windows, macOS, Linux, Android에서 사용할 수 있습니다.

핵심 기능

• Deezer 계정으로 로그인하여 트랙, 앨범, 플레이리스트 탐색
• 스트리밍 재생 및 로컬 재생 (디스크립트 복호화 지원)
• Discord 연동: 현재 재생 중인 트랙을 Discord 상태에 표시 (선택 사항)
• 터미널 모드에서는 키보드만으로 탐색 및 제어 가능
• GUI 모드에서는 Windows 10/11에서 WebView2 기반 로그인 웹뷰 제공

지원 환경 (Windows)

• Windows 10 버전 1809 이상 또는 Windows 11
• .NET 8 SDK + Windows App SDK 워크로드
• MinGW-w64 (Go cgo를 통해 엔진 DLL 빌드)
• Edge WebView2 런타임 (Windows 11에 사전 설치됨)

기본 사용법

1. 공식 저장소에서 소스 코드를 클론하거나 릴리스 바이너리를 다운로드합니다.
2. Windows에서는 .NET 8 SDK와 MinGW-w64가 설치된 환경에서 빌드하거나 제공된 실행 파일을 실행합니다.
3. 첫 실행 시 WebView2 기반 로그인 창이 나타나며, Deezer 계정으로 로그인합니다.
4. 로그인 후 터미널 또는 GUI에서 음악을 탐색하고 재생할 수 있습니다.
5. Discord가 실행 중이면 환경 변수 OPENDEEZER_DISCORD_APP_ID를 설정하거나 설정 파일에 앱 ID를 넣어 현재 재생 정보를 표시할 수 있습니다.

제한 사항 및 체크포인트

• Windows GUI를 사용하려면 .NET 8 SDK와 Windows App SDK, MinGW-w64가 필수입니다.
• WebView2 런타임이 없으면 로그인 웹뷰를 표시할 수 없습니다 (Windows 11에는 기본 포함).
• Discord 연동은 선택 사항이며, 관련 환경 변수나 설정 파일이 없으면 단순히 생략됩니다.
• 증거에 기반한 기타 운영 체제(Android, macOS, Linux) 지원 방법은 별도의 빌드 도구가 필요하며 이 문서에서는 Windows 사용자를 중심으로 설명합니다.

FAQ

• Deezer 계정이 반드시 필요한가요?
  예, 스트리밍 및 라이브러리 탐색을 위해서는 Deezer 계정으로 로그인해야 합니다.
• 터미널 전용으로만 사용할 수 있나요?
  아니요, TUI와 GUI 두 가지 모드를 모두 제공하므로 환경에 따라 선택할 수 있습니다.
• Discord 연동을 사용하려면 어떤 준비가 필요합니까?
  Discord 애플리케이션이 실행 중이고, OpenDeezer에 Discord 앱 ID를 설정해야 합니다 (환경 변수 또는 설정 파일).