swingmx/swingmusic

어떤 프로젝트인가요?

핵심 기능

• 01로컬 오디오 파일을 검색하고 메타데이터와 앨범 버전 표시를 정규화해 정리합니다.
• 02데일리 믹스, 관련 아티스트와 앨범, 음악을 분류하는 컬렉션을 제공합니다.
• 03폴더 보기에서 디렉터리별로 라이브러리를 탐색할 수 있습니다.
• 04청취 통계와 Last.fm 스크로블링을 지원합니다.
• 05무음 감지와 크로스페이드를 결합해 끊김 없이 재생합니다.
• 06Windows, Linux, macOS와 x86, arm64 빌드에서 다중 사용자 기능을 지원합니다.

활용 사례

• 구독 없이 개인 MP3 또는 FLAC 컬렉션을 브라우저나 홈 네트워크로 스트리밍합니다.
• 사용자마다 별도 계정을 사용하는 가정용 음악 서버를 운영합니다.
• Android 기기에서 컴패니언 클라이언트로 셀프 호스팅 라이브러리를 재생합니다.

빠른 시작

1. 1

   Docker 이미지를 pull합니다

   docker pull ghcr.io/swingmx/swingmusic:latest
2. 2

   음악 및 설정 경로를 자신의 경로로 바꿔 컨테이너를 실행합니다

   docker run --name swingmusic -p 1970:1970 -e SWINGMUSIC_PORT=1970 -e SWINGMUSIC_DEVICE_NAME="Host Name Here" -v /path/to/music:/music -v /path/to/config:/config --restart unless-stopped ghcr.io/swingmx/swingmusic:latest
3. 3

   브라우저에서 http://localhost:1970을 열어 Swing Music을 설정하고 사용합니다

사용 전 알아둘 점

• !라이선스는 AGPL-3.0입니다. 카피레프트 라이선스이므로 네트워크를 통해 제공하는 파생 서비스는 소스 코드를 공개해야 합니다.
• !README의 크로스 플랫폼 기능 목록에는 macOS 지원이 '곧 제공 예정'으로 표시되어 있지만, 설치 안내에는 macOS가 언급되어 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

swingmusic은(는) 무엇인가요?

Spotify와 비슷한 인터페이스로 로컬 음악 파일을 스트리밍하는 셀프 호스팅 서버 겸 브라우저 기반 플레이어입니다. Swing Music은 로컬 오디오 파일이 있는 폴더를 색인하고 브라우저 기반 플레이어로 음악을 제공하는 셀프 호스팅 음악 서버입니다. 자신의 음악 라이브러리를 직접 관리하면서 Spotify와 비슷한 방식으로 음악을 듣고 싶은 사용자를 위한 프로젝트입니다.

swingmusic은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

swingmusic은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

swingmusic은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. swingmusic의 마지막 커밋은 2026년 11월 6일입니다.

swingmusic은(는) 어디에 사용할 수 있나요?

구독 없이 개인 MP3 또는 FLAC 컬렉션을 브라우저나 홈 네트워크로 스트리밍합니다. 사용자마다 별도 계정을 사용하는 가정용 음악 서버를 운영합니다. Android 기기에서 컴패니언 클라이언트로 셀프 호스팅 라이브러리를 재생합니다.

swingmusic는 어떻게 설치하나요?

Docker 이미지를 pull합니다: docker pull ghcr.io/swingmx/swingmusic:latest 음악 및 설정 경로를 자신의 경로로 바꿔 컨테이너를 실행합니다: docker run --name swingmusic -p 1970:1970 -e SWINGMUSIC_PORT=1970 -e SWINGMUSIC_DEVICE_NAME="Host Name Here" -v /path/to/music:/music -v /path/to/config:/config --restart unless-stopped ghcr.io/swingmx/swingmusic:latest 브라우저에서 http://localhost:1970을 열어 Swing Music을 설정하고 사용합니다

swingmusic은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/swingmx/swingmusic