# Petrichor – macOS용 무료 오픈소스 오프라인 음악 플레이어

> Clean Markdown view of GeekNews topic #22300. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=22300](https://news.hada.io/topic?id=22300)
- GeekNews Markdown: [https://news.hada.io/topic/22300.md](https://news.hada.io/topic/22300.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2025-08-03T09:31:01+09:00
- Updated: 2025-08-03T09:31:01+09:00
- Original source: [github.com/kushalpandya](https://github.com/kushalpandya/Petrichor)
- Points: 14
- Comments: 1

## Summary

로컬 **음악 파일**을 효율적으로 관리하고 완전한 **오프라인 감상**을 지원하는 macOS 전용 무료 **오픈소스 음악 플레이어**입니다. **Swift/SwiftUI**와 **AVFoundation** 등 최신 기술을 사용해 폴더 기반 라이브러리 탐색, 강력한 **메타데이터 검색**, 사이드바 Pin, 미디어 단축키 등 현대적 사용성을 제공합니다. 모든 데이터 관리는 **SQLite/GRDB**로 처리되어 원본 파일 변형 없이 대용량 음악 컬렉션도 신속하게 다룰 수 있습니다.

## Topic Body

- 로컬 음악 파일 컬렉션을 효율적으로 관리하고, 완전히 오프라인으로 감상할 수 있는 **macOS 전용 무료 오픈소스 음악 플레이어**  
- 지원 포맷: **MP3, M4A, WAV, AAC, AIFF, FLAC**  
- **폴더 단위로 라이브러리 구성 및 탐색** 가능  
- 플레이리스트 생성 및 큐 관리   
- **어떤 것이든 Pin 하여 사이드바에 고정**하고 좋아하는 음악에 빠른 접근 가능  
- 트랙 우클릭 시 앨범, 아티스트, 연도 등 메타데이터 기반 탐색   
- macOS 네이티브: 메뉴바/독 재생 컨트롤, 다크모드, 단축키 지원  
- 대용량 라이브러리도 메타데이터 기반으로 **고속 검색** 가능  
- **MIT 라이선스**  
  
### 개발/구현 특징  
  
- **Swift/SwiftUI** 기반, 최신 macOS 인터페이스 적극 활용  
- 폴더 스캔 후 **SQLite/GRDB** 기반 데이터베이스 자동 구축, **모든 음악 파일은 읽기 전용으로 관리**되어, 원본 파일은 변형되지 않음  
- **검색**은 SQLite FTS5 기반, 인메모리 검색 폴백 제공  
- **재생 엔진**은 AVFoundation 기반  
- **Swinsian** 등 기존 macOS 오프라인 플레이어의 부족함을 보완하고, 스트리밍 앱의 현대적 UX도 참고  
  
### 향후 개발 예정 기능  
  
- 조건 기반 스마트 플레이리스트  
- 오디오 이퀄라이저  
- 추가 오디오 포맷(Opus, OGG 등) 지원  
- AirPlay 2 송출 지원  
- 미니플레이어/전체화면 모드  
- 자동 인앱 업데이트  
- 온라인 앨범/아티스트 정보 연동

## Comments



### Comment 42056

- Author: iolothebard
- Created: 2025-08-03T17:40:16+09:00
- Points: 1

문득.. 20년전에 만들었던 뮤직플레이어가 떠올랐음. 그놈의 기본 뮤직플레어가 리듬박스로 바뀔무렵이었는데… mp3 id3 한글이 깨져서 업스트림 패치보냈는데 안받아줘서… 패치하다하다 빡쳐서 만들었던 기억이…   
https://github.com/iolo/liteamp
