Kopuz

다중 백엔드 지원

Kopuz는 로컬 디렉터리 스캔 외에도 Jellyfin, Subsonic(Navidrome 포함) 서버에서 음악을 스트리밍할 수 있습니다. 또한 YouTube Music, SoundCloud, Spotify와 같은 주요 스트리밍 플랫폼과 연동되어 하나의 통합 인터페이스에서 모든 음악 소스를 탐색하고 재생할 수 있습니다. 각 백엔드는 고유한 기능을 유지하면서도 일관된 사용자 경험을 제공합니다.

스트리밍 서비스 상세 기능

YouTube Music

YouTube Music 백엔드는 로그인 시 개인 라이브러리, 좋아요 한 음악, 플레이리스트 접근을 제공하며, 비로그인 상태에서도 공개 트랙 검색 및 재생이 가능합니다. Discover 페이지에서 추천 곡, 플레이리스트, 앨범, 아티스트 및 분위기별 탐색이 가능하며, 아티스트 프로필에서는 배너, 인기 곡, 앨범, 싱글 및 관련 아티스트 정보를 확인할 수 있습니다. 믹스 라디오 기능을 통해 어떤 트랙부터 시작해도 유사한 스타일의 음악을 지속적으로 들을 수 있습니다.

SoundCloud

SoundCloud 연동을 통해 프로그레시브 MP3 및 Go+ AAC/HLS 스트림으로 트랙 재생이 가능하며, 좋아요 한 트랙을 즐겨찾기로 저장하고 읽기 전용 플레이리스트에 접근할 수 있습니다. 로그인 시 isolated 브라우저 프로필을 통해 안전하게 인증이 이루어집니다.

Spotify

Spotify Premium 계정이 필요하며, 공식 Web Playback SDK를 통해 오디오 재생이 이루어집니다. 저장된 트랙은 즐겨찾기로, 앨범은 라이브러리로, 플레이리스트는 탐색 가능하며 Discover 페이지와 검색 기능을 제공합니다. 스크로블링을 통해 Last.fm, Libre.fm 및 ListenBrainz에 재생 기록을 전송할 수 있습니다. 단, 개발 모드 제한으로 인해 플레이리스트 생성 및 편집은 불가능하며, 검색 결과는 유형당 최대 10개로 제한됩니다.

로컬 음악 관리

로컬 오디오 파일을 스캔하여 라이브러리에 추가할 때, 파일 형식 배지(MP3, FLAC, WAV 등)를 통해 트랙 행에서 소스 형식을 한눈에 확인할 수 있습니다. 아티스트, 앨범, 장르별로 탐색하거나 맞춤 플레이리스트를 생성 및 관리할 수 있으며, 장르별 브라우징 기능을 통해 로컬 및 서버 음악을 장르별로 탐색할 수 있습니다.

사용자 경험 및 접근성

실시간 가사 표시 기능으로 싱크된 가사와 일반 가사를 제공하며, 자동 스크롤을 통해 음악에 맞춰 가사를 따라갈 수 있습니다. 즐겨찾기 기능을 통해 로컬로 트랙을 별표하거나 Jellyfin/Subsonic 서버와 즐겨찾기 동기화가 가능합니다. 재생 횟수를 추적하는 청취 로그 기능을 통해 가장 많이 들은 음악을 확인할 수 있습니다. ListenBrainz로 스크로블링이 가능하며, Jellyfin 사용자는 관련 플러그인 사용을 권장합니다.

고급 오디오 기능

내장된 10밴드 이퀄라이저는 프리셋 및 커스텀 설정을 통해 사운드를 세밀하게 조정할 수 있으며, 크로스페이드 기능으로 트랙 간 자연스러운 전환이 가능합니다. 채널 모드를 통해 스테레오, 모노, 왼쪽만, 오른쪽만, 또는 L/R 채널 교환 중 선택할 수 있습니다. yt-dlp 통합을 통해 YouTube 및 기타 지원 사이트에서 오디오를 직접 다운로드할 수 있으며, 출력 형식으로 Best Audio, MP3, FLAC, Opus, WAV 또는 MP4 비디오 중 선택 가능합니다. SponsorBlock, 챕터 분할, 쿠키 및 속도 제한 기능도 지원됩니다.

시스템 통합 및 편의 기능

시스템 미디어 컨트롤과의 통합을 통해 Windows에서는 시스템 미디어 전송 컨트롤(MPRIS 대체)을 지원합니다. 미니 플레이어 기능을 통해 하단 바에서 kompakt한 지금 재생 중 보기 토글이 가능하며, 트레이 아이콘으로 최소화하여 백그라운드에서 재생을 유지할 수 있습니다. 디스코드 RPC 연동을 통해 현재 재생 중인 음악을 디스코드 프로필에 표시할 수 있습니다. 테마 기능을 통해 시각적 외관을 커스터마이징할 수 있으며, 사용자 정의 폰트 적용으로 인터페이스를 원하는 대로 꾸밀 수 있습니다. 애니메이션 감소 설정으로 접근성을 향상시켰으며, 스mooth 네비게이션을 통해 다양한 뷰 간 스크롤 위치가 올바르게 리셋됩니다.

라이브러리 관리

라이브러리, 플레이리스트, 즐겨찾기 및 설정은 로컬 SQLite 데이터베이스(kopuz.db)에 저장되며, 설정은 인간 편집이 가능한 settings.toml 파일에 미러링됩니다. 앨범 아트와 다운로드 트랙은 캐시 디렉터리에 저장되며, 자동 정리 기능을 통해 rescanning 시 삭제되거나 이동된 트랙을 라이브러리에서 자동으로 제거합니다. 파일 유형 배지를 통해 로컬 트랙의 형식을 트랙 행에서 바로 확인할 수 있으며, 실시간 검색 및 빠른 검색 오버레이를 통해 아티스트, 앨범 및 트랙을 즉시 찾아볼 수 있습니다.

다운로드·설치 방법

Windows 사용자는 공식 홈페이지에서 MSI 설치 프로그램을 다운로드하여 설치할 수 있습니다. 설치 과정은 표준 Windows 설치 마법사를 따르며, 관리자 권한이 필요하지 않을 수 있습니다. 설치 완료 후 시작 메뉴에서 Kopuz를 찾아 실행할 수 있습니다. 공식 홈페이지에서는 최신 버전의 MSI 설치 프로그램을 제공하며, GitHub 저장소에서도 소스 코드 및 다양한 플랫폼별 설치 방법을 확인할 수 있습니다.

기본 사용법

Kopuz를 처음 실행하면 설정 마법사가 표시되지 않으며, 바로 메인 인터페이스가 나타납니다. 왼쪽 사이드바에서 로컬 폴더, 스트리밍 서비스(YouTube Music, SoundCloud, Spotify 등) 및 Jellyfin/Subsonic 서버를 추가할 수 있습니다. 로컬 음악을 추가하려면 ‘로컬 폴더 추가’ 옵션을 통해 음악이 저장된 디렉터리를 지정하면 자동으로 스캔이 시작됩니다. 스트리밍 서비스를 연결하려면 설정 → 미디어 서버 추가 → 해당 서비스 선택 순으로 진행하며, 각 서비스별로 브라우저 기반 인증이 이루어집니다. 재생 중에는 하단 컨트롤 바에서 재생/일시정지, 이전/다음 트랙, 볼륨 조절이 가능하며, 시스템 미디어 키를 통해서도 제어가 가능합니다. 지금 재생 중인 트랙 정보를 보려면 하단의 미니 플레이어를 토글하거나 메인 화면에서 확인할 수 있습니다.

이런 경우에 유용합니다

로컬에 저장된 MP3, FLAC, WAV 등 다양한 형식의 음악 파일을 보유한 사용자가 폴더별로 흩어진 파일을 통합적으로 관리하고 싶을 때 유용합니다. 여러 스트리밍 서비스 구독자를 위해 YouTube Music, SoundCloud, Spotify 계정을 하나의 인터페이스에 연결하여 별도의 앱을 오가며 전환할 필요 없이 모든 음악을 탐색하고 재생할 수 있습니다. 오디오 파일을 자주 다운로드하거나 관리하는 사용자가 yt-dlp 통합 기능을 통해 YouTube에서 오디오를 직접 다운로드하고 형식 변환 및 메타데이터 관리를 한 번에 처리할 때 편리합니다. 시스템 트레이에서 백그라운드 재생을 유지하면서 다른 작업을 할 필요가 있는 사용자는 트레이 아이콘 최소화 기능을 통해 음악 재생을 중단하지 않고 작업할 수 있습니다.

지원 환경·시스템 요구사항

Windows 운영 체제에서 실행되며, 64비트(x64) 아키텍처를 지원합니다. 공식 배포 형태는 MSI 설치 프로그램으로 제공됩니다. 최신 버전에서는 Windows 시스템 미디어 전송 컨트롤과의 통합이 지원되며, 트레이 아이콘 기능을 사용하기 위해서는 별도의 앱인디케이터 라이브러리가 필요하지 않습니다(Windows에서는 기본적으로 지원됨).

최신 버전·업데이트

현재 버전은 0.16.1이며, 공식 홈페이지와 GitHub 저장소에서 최신 릴리스 정보를 확인할 수 있습니다. 버전 업데이트 시 새로운 기능 추가, 성능 개선 및 버그 수정이 포함됩니다. 업데이트 방법은 공식 홈페이지에서 최신 MSI 설치 프로그램을 다운로드하여 재설치하거나, GitHub의 릴리스 페이지에서 제공하는 설치 파일을 사용하는 것입니다.

제한 사항·확인 사항

Spotify 백엔드를 사용하기 위해서는 Spotify Premium 계정이 필수이며, 무료 계정에서는 오디오 재생이 불가능합니다. Spotify 연동을 위해서는 공식 Spotify 개발자 콘솔에서 클라이언트 ID를 생성하고 Kopuz에 입력해야 하는 초기 설정이 필요합니다. YouTube Music의 프리미엄 전용 트랙을 비로그인 상태에서는 재생할 수 없으며, yt-dlp가 설치되어 있어야 일부 프리미엄 트랙 재생이 가능할 수 있습니다. AppImage 형식의 경우 웹킷2GTK-4.1 및 GTK3 의존성이 시스템에 별도로 설치되어 있어야 하며, 트레이 아이콘 표시를 위해서는 앱인디케이터 라이브러리가 필요합니다(Windows에서는 이 제한이 적용되지 않음).

FAQ

• Kopuz는 무료로 사용할 수 있나요?
  예, Kopuz는 MIT 라이선스 하에 오픈소스로 제공되며, 무료로 다운로드하고 사용할 수 있습니다.
• Windows에서 Kopuz를 어떻게 시작하나요?
  시작 메뉴에서 ‘Kopuz’를 찾아 실행하거나, 데스크톱에 생성된 바로가기를 더블클릭하여 실행할 수 있습니다.
• 인터넷 연결이 필수인가요?
  로컬 음악 파일만 재생하는 경우에는 인터넷 연결이 필요하지 않지만, YouTube Music, SoundCloud, Spotify 및 Jellyfin/Subsonic과 같은 스트리밍 서비스를 사용하기 위해서는 인터넷 연결이 필요합니다.
• Kopuz는 어떤 언어를 지원하나요?
  사용자 인터페이스는 아랍어, 브라질 포르투갈어, 네덜란드어, 영어, 유럽 포르투갈어, 필리핀어, 프랑스어, 독일어, 그리스어, 히브리어, 헝가리어, 인도네시아어, 이탈리아어, 일본어, 한국어, 말라얄람어, 폴란드어, 루마니아어, 러시아어, 간체 중국어, 스페인어, 스웨덴어, 타밀어, 토키 포나, 터키어, 우크라이나어, 베트남어 및 시텔렌 포나를 지원합니다.