astra

# Astra Astra는 로컬 음악 라이브러리를 유지하는 사람들을 위해 설계된 데스크톱 음악 플레이어입니다. FLAC, MP3, WAV, OGG, AAC, M4A, OPUS, WMA, AIFF, ALAC, APE, WavPack 등의 형식을 기본 지원하며, 다른 형식은 FFmpeg 폴백을 사용합니다. 사전 버퍼링을 통한 갭리스 재생으로 앨범이 끊김 없이 이어집니다. ## 주요 기능 - **비트 퍼펙트 출력**: Windows의 WASAPI Exclusive, macOS의 CoreAudio HAL, Linux의 ALSA hw를 통해 OS 믹서를 우회하여 하드웨어로 직접 전달합니다. - **공간 음향**: 네이티브 IAMF/Eclipsa Audio 재생을 지원하며, 이를 지원하는 최초의 범용 데스크톱 음악 라이브러리 플레이어입니다. Atmos 호환 하드웨어 없이도 Dolby Atmos 멀티채널 디코딩을 포함합니다. 채널별 검사, 리매핑, 출력 지연 보정, 그리고 실시간 바이노럴 렌더링을 통한 3D 스피커 배치용 Virtual Speaker Room 기능을 제공합니다. - **Parallax**: 로컬 네트워크상의 여러 머신 간 동기화된 멀티룸 재생. 하나의 호스트가 재생을 제어하고, 다른 기기들은 PIN 페어링과 스피커별 지연 튜닝을 통해 스피커로 참여합니다. 선택적이며 실험적 기능입니다. - **시각화**: 네이티브 C++ 모듈로 구동되는 7가지 실시간 시각화(오실로스코프, 스펙트럼 분석기, 벡터스코프 등)를 제공합니다. 드래그 앤 리사이즈 레이아웃과 프리셋을 지원하는 사용자 정의 스코프 랙을 포함합니다. - **이퀄라이저**: 최대 20개의 완전 파라메트릭 밴드, 스펙트럼 오버레이가 있는 실시간 주파수 응답 그래프, 내장 프리셋, AutoEQ 헤드폰 보정 프로필 가져오기를 지원합니다. - **라이브러리 관리**: 메타데이터 추출, 앨범 아트워크, 아티스트/앨범/트랙별 검색 브라우징, ID3v2.4 및 Vorbis Comments 지원, 다중 아티스트 태그 파싱, 사용자 정의 아티스트 이미지, .lrc 파일 스캔, 즐겨찾기, 최근 재생 추적, 내장 메타데이터 편집기를 제공합니다. - **Astra Resolve**: 라이브러리 컨텍스트를 사용하여 단일 아티스트 크레딧과 협업을 구분하고, 파일을 다시 쓰거나 외부 메타데이터를 조회하지 않고도 아티스트 링크를 정확하게 유지합니다. - **오디오 설정**: 출력 장치 선택, ReplayGain 라우드니스 정규화, 채널별 리매핑, 무선/블루투스 스피커용 지연 보정을 제공합니다. - **인터페이스**: 파형 탐색 바, 앰비언트 스펙트럼 배경의 전체 화면 모드, 미니 플레이어, 자동 스크롤이 있는 동기화 가사(내장 가사, .lrc 파일 또는 LRCLIB에서), 팝아웃 가사 패널을 제공합니다. - **스크로블링**: Last.fm, AudioScrobbler, ListenBrainz 기본 지원과 사용자 정의 스크로블러 프로필, 여러 서비스로의 멀티스크로블을 제공합니다. - **통합**: 선택적 Discord Rich Presence와 자체 호스팅 미디어 서버 지원(Jellyfin, Navidrome, Airsonic, Gonic, Funkwhale 등 Subsonic 호환 서버)을 제공합니다. - **Astra API**: 외부 도구가 재생을 관찰/제어하고, 검색하고, 대기열과 즐겨찾기를 관리할 수 있도록 베어러 인증이 있는 선택적 컴패니언 API입니다. /v1 및 /v2 계약을 지원합니다. - **실험적 기능**: PWA 폰 컨트롤러, 라이브러리 무결성 스캐너, 그래프 시각화, 앰비언트 스테레오-멀티채널 업믹스, 5×5 그리드 활동 표시기, 컨트롤러 지원(Xbox/PlayStation)을 제공합니다. ## 다운로드 및 설치 Windows, macOS, Linux용 사전 빌드 바이너리는 Releases 페이지에서 제공됩니다. AUR(`astra-music-bin`)과 Windows `winget install Boof2015.Astra`로도 설치할 수 있습니다. 커뮤니티 유지 관리 패키지로는 AUR 소스와 Fedora/RPM용 TerraPKG가 있습니다. ## 소스에서 빌드 Node.js 18+, npm, C++ 컴파일러 툴체인이 필요합니다. 저장소를 클론하고 `npm install`을 실행한 후(네이티브 시각화 모듈이 컴파일됨), `npm run dev`, `npm run build` 또는 패키징을 위해 `npm run dist`를 사용합니다. ## 문서 및 지원 자세한 기술 문서는 Wiki에 있습니다. 이 프로젝트는 GPL v3.0 라이선스이며 Ko-fi를 통해 개발을 지원할 수 있습니다.