Tune by Mozaiklabs

문제 해결

가장 흔한 문제와 그 대처 방법입니다. 아무것도 소용없다면 Tune에서 보고서를 보내 주세요. 진단에 필요한 모든 내용이 들어 있습니다.

인터페이스가 열리지 않음

  • Tune이 실행 중인지 확인합니다. Windows에서는 콘솔 창, sudo systemctl status tune-server(.deb 패키지), Tune OS에서는 sudo systemctl status tune입니다.
  • 주소는 http://<server-address>:8888입니다. Tune OS에서는 http://tune-XXXX.local 또는 http://<IP-address>입니다.
  • 방금 설치한 Tune OS: 첫 부팅에는 15분에서 30분이 걸리며 자동으로 두 번 재부팅됩니다. SSH로 이미 응답하는 기기가 반드시 끝난 것은 아닙니다. 진행 상황은 /var/log/tune-os-firstboot.log에 기록됩니다.
  • Windows에서 다른 기기로 접근할 수 없음: Windows 방화벽이 “비공개 네트워크” 프로필에서 Tune을 차단하고 있습니다. Windows 방화벽에서 비공개 네트워크에 대해 tune-server.exe를 허용하세요. 같은 차단 때문에 DLNA 검색도 되지 않습니다.
  • 포트가 이미 사용 중: TUNE_PORT로 다른 포트를 지정하세요(설정 참조). Windows에서는 1.0.0-rc2부터 Tune이 이미 실행 중일 때 바로 가기로 다시 실행하면 실행 중인 인스턴스가 브라우저에서 열릴 뿐입니다.
  • Docker: 컨테이너가 계속 재시작됨 (NAS에서는 예기치 않게 멈춤): /data에 마운트한 폴더에 tune 사용자(uid 1000)가 쓸 수 없습니다. Docker가 직접 만든 폴더(예: ./data)가 이런 경우입니다. 이름 있는 볼륨 tune-data:/data로 바꾸거나(시작하기 참고), 폴더 소유자를 uid 1000으로 바꾸세요: sudo chown -R 1000:1000 ./data. 그런 다음 docker compose up -d를 다시 실행하세요.

기기가 나타나지 않음

  • 기기와 서버는 같은 네트워크(같은 서브넷, 같은 VLAN)에 있어야 합니다. 검색은 멀티캐스트를 사용합니다: SSDP(UDP 1900)와 mDNS(UDP 5353).
  • Docker에서는 network_mode: host를 사용하세요.
  • 설정 › 오디오 › 무시한 기기를 확인하세요. 기기가 숨겨졌을 수 있습니다.
  • 기기에 네트워크 카드가 여러 개(또는 VPN)라면, TUNE_ADVERTISED_IP로 Tune이 알릴 주소를 지정하세요.
  • 같은 기기의 LMS가 포트 3483을 점유하고 있으면 Squeezebox 플레이어가 Tune을 볼 수 없습니다.

소리가 나지 않음

로컬 출력

  • 설정 › 오디오 › 로컬 오디오 출력의 오디오 백엔드를 확인하세요. Windows에서 ASIO에는 DAC 제조사의 드라이버가 필요합니다.
  • 다른 애플리케이션이 독점 모드로 DAC를 점유하고 있을 수 있습니다. 그 애플리케이션을 닫으세요.
  • Linux(.deb 패키지): 서비스는 tune 사용자로 실행되므로, 이 사용자가 audio 그룹에 속해 있어야 합니다.
  • Linux: 1.0.0-rc1에서는 ALSA/PipeWire 검색이 멈추면 Tune 전체가 멈춰 직접 다시 시작해야 했습니다. 1.0.0-rc2부터는 이런 멈춤이 더 이상 서버를 멈추게 하지 않습니다. 그래도 오디오 출력이 사라지면 Tune에서 보고서를 보내 주세요.
  • 프로세서가 하나뿐인 컴퓨터: 1.0.0-rc2부터 Tune은 항상 작업 스레드를 4개 이상 유지하여, 로컬 재생을 끊던 몇 초간의 멈춤을 막습니다.

네트워크 기기

  • 설정 › 오디오 › 오디오 진단(전문가 수준)과 재생 바의 신호 경로에서 기기로 보내는 내용을 볼 수 있습니다.
  • 기기가 보내는 형식을 받아들이는지 확인하세요. DSD의 경우 설정 › 기기 › 존별 설정에서 자동 또는 PCM (변환)을 시도해 보세요.
  • 렌더러로 DSD 256/512를 보낼 때 끊김이 있는 경우: 설정 › 오디오 › DSD 재생(네트워크 렌더러)에서 연속 스트리밍 옵션을 사용하세요. 1.0으로 업데이트한 뒤에는 이 옵션이 여전히 선택한 그대로인지 확인하세요.

Windows: 시작할 때 ASIO가 WASAPI로 되돌아감

증상: ASIO를 선택했는데 Tune을 시작하면 WASAPI 출력(예: “스피커”)만 나타나거나 재생이 멈춥니다. 1.0.0-rc2에서 이 전환의 알려진 두 가지 원인이 수정되었습니다. 이제 Tune은 ASIO 드라이버 검색이 끝날 때까지 기다린 뒤에 WASAPI로 전환합니다. 그래도 전환되었다면, 로컬 출력에서 아무것도 재생하지 않을 때 다음 장치 검색에서 스스로 ASIO로 돌아갑니다.

  • 설정 › 오디오 › 로컬 오디오 출력 › 오디오 백엔드가 ASIO로 설정되어 있고 제조사의 ASIO 드라이버가 설치되어 있는지 확인하세요.
  • Tune을 다시 시작하세요.
  • Tune에 충돌 후 ASIO 검색이 일시 중지됨이 표시되면, 충돌이 반복되는 것을 피하기 위해 ASIO 드라이버 검색을 꺼 둔 것입니다. ASIO 검색 재활성화를 클릭한 다음 Tune을 다시 시작하세요.
  • 문제가 계속되면 Tune에서 보고서를 보내 주시고, 사용 중인 DAC와 드라이버를 적어 주세요.

Tune OS: 1.0.0-rc1에서 커버와 아티스트 사진이 사라짐

1.0.0-rc1의 Tune OS는 커버 캐시를 /opt/tune/data/artwork_cache에서 찾았지만, 이전 버전은 /opt/tune/artwork_cache에 저장했습니다. 그래서 거의 모든 커버와 아티스트 사진이 사라진 것처럼 보였습니다. 1.0.0-rc2에서 이 문제가 수정되었습니다. 시작할 때 Tune은 원래 캐시를 다시 사용하고, rc1이 다른 곳에 저장한 것을 그곳으로 복사합니다. 아무것도 덮어쓰거나 지우지 않습니다. 따라서 Tune을 업데이트하기만 하면 됩니다. 이미 이미지를 직접 복사했다면 되돌릴 것은 없습니다.

라이브러리

  • 추가한 폴더가 나타나지 않음: 경로가 Tune을 실행하는 기기에 존재해야 하고, Tune이 실행되는 계정이 읽을 수 있어야 합니다. 처음 시작한 이후에는 TUNE_MUSIC_DIRS를 바꿔도 효과가 없습니다. 설정 › 라이브러리 › 위치를 사용하세요.
  • 네트워크 공유의 변경 사항이 보이지 않음: Tune은 15분마다 공유를 확인합니다. 빠르게 하려면 라이브러리 스캔을 다시 실행하세요.
  • ReplayGain 게이지가 0 %로 돌아감: 1.0.0-rc1에서는 업데이트나 재시작 후 이런 일이 있었습니다. 1.0.0-rc2부터는 라이브러리 전체에서 이미 분석된 트랙 수를 보여 줍니다.
  • 시작할 때 네트워크 공유가 아직 준비되지 않음: 1.0.0-rc2부터 Tune이 직접 마운트하는 SMB 공유는 첫 마운트 시도를 기다린 뒤에 라이브러리를 분석하고, 이후 백그라운드에서 약 5분 동안 다시 시도합니다. 공유가 없는 동안 커버가 지워지지 않습니다.
  • 업데이트 후 커버가 바뀜: 1.0.0-rc2부터 폴더 이미지(예: cover.jpg 또는 folder.jpg)가 파일에 내장된 커버보다 우선합니다. 디스크마다 폴더를 나눈 박스 세트에서는 박스 세트 최상위 폴더의 이미지가 사용됩니다. 직접 업로드한 커버는 절대 바뀌지 않습니다.
  • 백그라운드 분석이 기기 자원을 너무 많이 사용함: 설정 › 오디오 › 백그라운드 분석 속도를 낮추거나, 서버 상태에서 일시정지하세요.

스트리밍 서비스

  • Deezer: “Deezer가 ARL을 거부했습니다” 또는 세션 끊김: deezer.com을 열어 새 arl 쿠키를 가져온 뒤 설정 › 접근과 토큰 › 스트리밍 서비스에 붙여 넣으세요.
  • TIDAL, Qobuz: 같은 위치에서 서비스 연결을 해제하고 다시 연결하세요.
  • YouTube: YouTube 재생 사용을 하지 않으면 검색은 되지만 재생이 실패합니다.
  • Spotify: 1.0에서는 카탈로그를 둘러볼 수는 있지만 재생할 수는 없습니다. 계정을 연결하려면 직접 만든 Spotify 앱의 Client ID가 필요합니다(스트리밍 서비스 참조).
  • Bandcamp: 며칠 뒤 대기열, 기록 또는 즐겨찾기에서 다시 재생한 트랙은 주소가 만료되어 재생되지 않을 수 있습니다. 1.0.0-rc2부터는 이 실패가 로그에 기록되고, Chromecast 존은 소리 없이 있지 않고 오류를 알리며 멈춥니다. 해당 트랙은 앨범 페이지에서 다시 재생하세요.

Tune에서 보고서 보내기

사이드바 맨 아래의 지원을 엽니다.

버그 신고(진단 탭)

누구나 라이선스 없이 이용할 수 있습니다. 무슨 일이 일어나나요를 설명하고, 필요하면 스크린샷을 추가한 다음 포럼에 보내기를 클릭하세요. 작성한 글, 진단 정보, 서버의 최근 로그가 검토를 거치는 포럼 스레드로 전송됩니다. 개인 경로는 보고서에서 제거되며, 첨부될 보고서 보기로 보내기 전에 내용을 확인할 수 있습니다.

Tune이 전송 한도 메시지로 응답하면(첫 시도에서도 나타날 수 있습니다. 알려진 문제이며 보고되었습니다), 보고서 복사를 사용해 포럼의 새 주제에 붙여 넣거나, 나중에 다시 시도하세요.

지원팀에 문의(티켓 탭)

이 양식은 Tune Premium 라이선스가 등록되어 있을 때 표시됩니다. 제목, 분류, 해당 존(선택), 내용, 첨부 파일(최대 5개 파일)이 있습니다. 로그와 시스템 정보 첨부는 체크한 채로 두세요. 이것이 없으면 진단에 여러 번 주고받아야 하는 경우가 많습니다. 요청의 진행 상황은 티켓 탭에서 확인하세요.

로그

  • 설정 › 시스템 › 서버 상태(고급 수준): 로그 다운로드 또는 진단 다운로드(로그, 진단 정보, 설정이 들어 있는 ZIP이며 자격 증명은 가려집니다). 로그 수준도 같은 곳에서 설정합니다.
  • 파일: 설정의 “데이터 위치” 표를 참조하세요.

함께 보기