OpenSource-Hub
M

musikcube

SHA-256
4.8k stars·시스템 최적화·SHA-256 체크섬 확인됨

Windows, macOS, Linux 및 Raspberry Pi를 지원하는 크로스 플랫폼 터미널 뮤직 플레이어이자 스트리밍 서버입니다.

스마트 다운로드

Download 버전 다운로드

v3.0.5 · 13.2 MB

터미널에서 실행되는 음악 플레이어로, 스트리밍 서버로도 사용할 수 있으며 Raspberry Pi에서도 구동됩니다.

주요 기능

  • 순수 터미널 인터페이스로 리소스 사용량이 적어 구형 기기나 라즈베리 파이에 적합
  • 다양한 오디오 형식 지원 (FFmpeg 사용)
  • HTTP/WebSocket 스트리밍 서버 내장, 원격 제어 지원
  • Android 원격 제어 앱 제공 (musikdroid)
  • 크로스 플랫폼 실행 지원, Windows/macOS/Linux 모두 가능

할 수 없는 것

  • •기본 스트리밍 서버는 평문 비밀번호를 사용하며 SSL이 없으므로 공용 네트워크에 직접 노출해서는 안 됩니다. 원격 액세스가 필요한 경우 리버스 프록시(예: Nginx)를 구성하여 HTTPS를 추가하십시오. 서버 비밀번호는 settings 파일에 저장되므로 안전하게 보관하십시오.

사용 사례

  • Raspberry Pi에서 홈 뮤직 서버를 구축하고 휴대폰으로 원격으로 곡을 선택하여 재생
  • 그래픽 인터페이스가 없는 서버에서 터미널을 사용하여 로컬 음악 라이브러리 관리
  • cmus / mpd 등 구식 터미널 플레이어를 대체하여 더 현대적인 조작 경험 제공

상세 설명

musikcube는 터미널에서 실행되는 크로스 플랫폼 음악 플레이어이자 스트리밍 서버로, C++로 작성되었습니다. Windows, macOS, Linux 및 Raspberry Pi를 지원하며, FFmpeg를 통한 풍부한 오디오 디코딩 기능과 ncurses 기반의 가벼운 TUI 인터페이스를 제공합니다. 스트리밍 서버가 내장되어 있어 Android 앱(musikdroid)을 통해 원격으로 제어하고 오디오를 재생할 수 있습니다. 설치 방법이 다양하여 Homebrew, Chocolatey, pkg 등의 패키지 관리자를 지원하며, 소스 코드에서 직접 컴파일할 수도 있습니다. 주의: 기본 서버는 암호화되어 있지 않고 비밀번호가 평문으로 저장되므로, 공용 인터넷에 노출하려면 리버스 프록시 SSL을 구성해야 합니다.

문제 해결 & FAQ (2)

문제 해결
왜 musikcube가 Windows에서 대문자 확장자를 가진 .MP3 또는 .WAV 파일을 재생하지 않나요?

이 문제는 musikcube의 대소문자 구분 파일 확장자 매칭 때문에 발생했습니다. 소문자 .mp3/.wav 파일은 정상적으로 작동했지만 대문자 .MP3/.WAV 파일은 무시되었습니다. 해당 버그가 수정된 musikcube 0.92.0 이상 버전으로 업그레이드하세요. 0.92.0 이전 버전에서는 파일의 확장자를 소문자로 변경하세요 (예: .MP3를 .mp3로). 이름을 변경한 후에도 중복되거나 오래된 항목이 남아 있는 경우, 라이브러리에서 음악 폴더를 제거하고 다시 추가한 다음 인덱스를 다시 빌드하세요.

원본 Issue #349
문제 해결
FFmpeg 8.0으로 musikcube를 빌드할 때 발생하는 'avcodec_close' undeclared 오류를 수정하는 방법은?

musikcube를 최신 릴리스 또는 현재 master 브랜치로 업그레이드하십시오. 제거된 avcodec_close API의 삭제/교체를 포함한 FFmpeg 8.0 호환성 수정 사항이 릴리스되었습니다. FreeBSD Ports를 사용하는 경우, ports 트리를 업데이트하고 multimedia/musikcube를 업그레이드하십시오. 소스 빌드의 경우, git fetch --tags && git checkout master && git pull을 실행한 후 클린하고 다시 빌드하십시오 (예: rm -rf build && cmake -S . -B build && cmake --build build -j$(nproc)). Musikcube 3.0.4는 FFmpeg 8.0에 대해 빌드에 실패하는 것으로 알려져 있습니다.

원본 Issue #736

태그

audiomusicterminalc++streamingraspberry-picross-platformserver

시작하기

1

설치 프로그램 다운로드

위 버튼을 클릭하여 시스템에 맞는 설치 프로그램을 다운로드

2

소프트웨어 설치

배포판에 맞는 패키지를 설치 (dpkg / rpm / AppImage)

3

해당 시스템의 release 압축 파일을 다운로드하거나 패키지 관리자로 설치하세요 (예: brew install musikcube)

4

압축 해제 후 더블 클릭하여 실행하거나 터미널에 musikcube를 입력하여 시작하세요

5

방향키로 로컬 음악 폴더를 탐색하고, Enter로 재생하며, ?를 눌러 단축키 도움말을 확인하세요

설치 가이드
  1. 해당 시스템의 release 압축 파일을 다운로드하거나 패키지 관리자로 설치하세요 (예: brew install musikcube)
  2. 압축 해제 후 더블 클릭하여 실행하거나 터미널에 musikcube를 입력하여 시작하세요
  3. 방향키로 로컬 음악 폴더를 탐색하고, Enter로 재생하며, ?를 눌러 단축키 도움말을 확인하세요
파일 무결성

SHA-256 체크섬 확인됨

GitHub 공식 Release 페이지에서 추출된 체크섬

SHA256 체크섬

9c908eacc4b3d0bf494bc0a72048a9f3bb59ed6471c4571da8f5441e277fc883

이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.

이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.

오픈소스 투명성

GitHub 소스 보기
환경 가이드

제거 정보

패키지 관리자를 통해 제거하거나(예: brew uninstall musikcube) 설치 디렉토리를 직접 삭제하세요. 구성 파일은 일반적으로 ~/.config/musikcube 또는 ~/.musikcube에 위치하며 수동으로 삭제할 수 있습니다.

추가 의존성 없음

다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.

프로젝트 정보
라이선스GPL-3.0
마지막 업데이트2026-10-15 06:50:20
GitHub 저장소

문제 발생? 아래 FAQ 확인

2 FAQs

유사한 프로젝트