시작하기

Tune은 멀티룸 음악 서버입니다. 로컬 파일과 네트워크 드라이브에 있는 음악과 스트리밍 서비스를 색인한 다음, 컴퓨터에 연결된 DAC, DLNA/UPnP 렌더러, AirPlay 스피커, Chromecast, Squeezebox 플레이어 등의 기기로 보내 줍니다. 로컬 네트워크의 어떤 기기에서든 웹 브라우저로 제어할 수 있습니다.

설치 방법 선택

가지고 계신 환경	설치
전용 기기(x86-64 미니 PC, Raspberry Pi 5)	Tune OS, 바로 사용할 수 있는 완전한 시스템
Windows PC	Windows 설치 프로그램(`…-windows-x86_64-setup.exe`)
Mac	macOS 디스크 이미지(`.dmg`) 또는 Homebrew
Debian, Ubuntu 또는 Raspberry Pi OS 컴퓨터	`.deb` 패키지
Docker를 실행하는 NAS 또는 서버	`renesenses/tune` Docker 이미지

모든 파일은 다운로드 페이지에 있습니다.

Windows

tune-server-v…-windows-x86_64-setup.exe를 실행합니다. 사용자 프로필(%LOCALAPPDATA%\Programs\Tune Server)에 설치되며 관리자 권한이 필요 없습니다.
바탕 화면 또는 시작 메뉴에서 Tune Server를 엽니다. 콘솔 창이 열리고(이것이 서버입니다. 열어 두세요), 이어서 브라우저에 http://localhost:8888의 Tune이 표시됩니다.
Windows 방화벽이 물어보면 비공개 네트워크에서 Tune을 허용하세요. 허용하지 않으면 다른 기기와 네트워크 렌더러가 Tune에 접근할 수 없습니다.

Tune은 Windows 서비스로 설치되지 않으며 로그인할 때 자동으로 시작되지 않습니다. 다시 시작하려면 Tune Server 바로가기를 사용하세요. .zip 압축 파일도 제공됩니다.

macOS

tune-server-v…-macos-….dmg 디스크 이미지를 열고 Tune Server를 응용 프로그램 폴더로 끌어다 놓습니다(macOS 13 이상).
Tune Server를 실행합니다. Dock에는 아이콘이 나타나지 않습니다. 서버를 시작하고 브라우저에서 http://localhost:8888을 엽니다.

Homebrew를 사용하는 경우:

brew tap renesenses/tap
brew install tune-server
brew services start tune-server

Linux(Debian, Ubuntu, Raspberry Pi OS)

.deb 패키지(amd64 또는 arm64)에는 Debian 12, Ubuntu 22.04, Raspberry Pi OS bookworm 이상이 필요합니다.

sudo apt install ./tune-server_<version>_<arch>.deb

tune-server 서비스는 즉시 시작되며, 기기가 부팅될 때마다 다시 시작됩니다. 그런 다음 http://<machine-address>:8888을 엽니다.

sudo systemctl status tune-server     # service status
sudo systemctl restart tune-server    # restart
journalctl -u tune-server -f          # follow the log

서비스는 tune 시스템 사용자(USB DAC에 접근할 수 있도록 audio 그룹의 구성원)로 실행됩니다. 이 사용자가 음악 폴더를 읽을 수 있어야 합니다. 다른 배포판용으로는 .tar.gz 압축 파일도 제공되지만, systemd 서비스는 설치되지 않습니다.

Docker

services:
  tune:
    image: renesenses/tune:latest
    container_name: tune
    network_mode: host
    restart: unless-stopped
    volumes:
      - /path/to/music:/music:ro
      - tune-data:/data
    environment:
      - TUNE_MUSIC_DIRS=["/music"]
      - TUNE_AUTO_SCAN=true

volumes:
  tune-data:

/path/to/music는 머신에서 음악이 들어 있는 폴더로 바꾸세요. Tune은 읽기 전용(:ro)으로 읽습니다. /data에는 이름 있는 볼륨 tune-data를 그대로 두세요. Tune은 tune 사용자(uid 1000)로 여기에 데이터베이스를 씁니다. Docker가 직접 만드는 호스트 폴더(예: ./data:/data)는 root 소유라서 Tune이 쓸 수 없고, 컨테이너가 계속 재시작됩니다. Synology나 QNAP NAS에서는 다운로드 페이지의 절차를 따르세요.

Tune이 네트워크의 기기(DLNA, AirPlay, Chromecast)를 찾으려면 network_mode: host가 필요합니다. Docker 이미지는 기기에 연결된 사운드 카드나 DAC로 재생할 수 없으며, 네트워크 기기에만 제공합니다. 스스로 업데이트하지 않으므로, 새 이미지를 받아(docker compose pull) 컨테이너를 다시 만드세요.

Tune OS

Tune OS는 기기를 전용 Tune 서버로 바꿔 주는 완전한 시스템입니다. 이미지는 세 가지가 있습니다.

x86-64 설치 프로그램(ISO): USB 메모리에 복사(Rufus, balenaEtcher)한 뒤 그것으로 기기를 부팅합니다. 대상 디스크가 지워지며, 비어 있는 디스크에만 설치됩니다. Secure Boot를 끈 UEFI PC, 4 GB RAM, 첫 부팅 때 사용할 유선 이더넷 연결이 필요합니다.
x86-64 기록용 이미지(.raw.xz): 기기의 디스크에 바로 기록합니다(balenaEtcher 또는 Rufus의 “DD Image” 모드).
Raspberry Pi 5(.raw.xz): Pi의 카드 또는 드라이브에 기록합니다.

첫 부팅에서는 아무것도 묻지 않습니다. 15분에서 30분이 걸리며, 기기가 저절로 두 번 재부팅됩니다. SSH로 이미 응답하더라도 끝날 때까지 기다리세요. 그런 다음 http://tune-XXXX.local(XXXX는 MAC 주소의 마지막 네 글자) 또는 http://<IP-address>를 엽니다. 기기의 화면에도 주소와 IP가 표시됩니다.

콘솔과 SSH의 계정은 tune이고 비밀번호도 tune입니다. passwd 명령으로 변경하세요. USB 드라이브는 /media 아래에 자동으로 마운트됩니다. Tune OS는 Tune 안에서 업데이트됩니다(설정 참조).

처음 실행

라이브러리가 비어 있는 동안에는 Tune이 Tune Server에 오신 것을 환영합니다 마법사를 엽니다.

시작하기. 다른 기기에서 옮겨 오는 경우, 다른 기기에서 옮겨 오셨나요?에서 백업을 가져올 수 있습니다.
음악 라이브러리: 음악 폴더의 경로를 입력하고(Tune을 실행하는 기기에서 보이는 대로, 예: /mnt/nas/Music 또는 D:\Music) 추가를 클릭합니다.
스트리밍 서비스: 지금 계정을 연결하거나 나중에 연결합니다(스트리밍 서비스 참조).
라이브러리 스캔: 스캔 시작. 스캔은 백그라운드에서 계속되므로 기다리지 않고 설정 완료를 클릭해도 됩니다.

마법사를 건너뛰고(설정 건너뛰기) 나중에 설정(사이드바 맨 위의 톱니바퀴 아이콘)에서 모두 설정할 수도 있습니다.

첫 곡 재생하기

Tune은 찾아낸 기기마다 자동으로 존을 만듭니다. 존은 자체 대기열과 볼륨을 가진 청취 대상입니다.
하단의 재생 바에서 존 이름(존 전환)을 클릭하고 들을 곳을 고릅니다. Tune을 보고 있는 기기에서 들으려면 이 브라우저를 선택하세요.
사이드바에서 라이브러리를 열고 앨범을 선택한 다음 재생을 클릭합니다.

화면 둘러보기

사이드바: 홈, 검색, 재생 중, 대기열, 재생 기록, 라이브러리, Oxygen, 스트리밍, 라이브 라디오, 팟캐스트. 이어서 선곡 그룹(컬렉션, 재생목록, 나중에 듣기, 태그, 즐겨찾기, 차단된 곡)이 있고, 맨 아래에 지원이 있습니다.
재생 바: 재생 컨트롤, 활성 존, 볼륨, 신호 경로, 오디오파일 모드(재생 및 존 참조).
인터페이스 수준: 계정 메뉴(오른쪽 위의 아바타)의 인터페이스 항목에서 기본, 고급, 전문가 중에서 선택합니다. 메뉴와 설정을 보이거나 숨길 뿐이며, 요금제와는 무관합니다. Tune은 모든 것을 보여 주는 전문가로 시작합니다. 이 가이드에 나오는 메뉴가 보이지 않으면 이 수준을 확인하세요.

다른 기기에서 Tune 사용하기

같은 로컬 네트워크의 어떤 기기든 브라우저에서 http://<server-address>:8888을 열 수 있습니다(Tune OS에서는 포트를 생략할 수 있습니다).

함께 보기

라이브러리 관리: 폴더, 네트워크 공유, 메타데이터
재생 및 존: 출력 기기, DSD, 비트 퍼펙트
문제 해결: 흔한 문제