원문: mintdotgg/bookshelf · 커밋
c9b28f8(2026-08-09) · Stars 약 90 · TypeScript · 라이선스 표기 없음
개요
README에서 앱 이름은 Side One이다. 호두나무 레코드 장에 꽂힌 LP 슬리브를 넘겨보다가 하나를 꺼내 앞뒤를 살피고, 트랙을 고르면 음반이 슬리브에서 빠져 턴테이블로 옮겨진 뒤 톤암이 내려앉는 과정을 Three.js로 재현한 촉각형 바이닐 카탈로그 겸 로컬 음악 플레이어다. 3D 에셋 도구를 만드는 Mint(mint.gg) 조직 저장소다.
무엇이 들어 있나
- 기본 카탈로그: Bob Dylan, Fleetwood Mac Rumours, Pink Floyd The Dark Side of the Moon, Miles Davis Kind of Blue 등 7개 릴리스·9개 프레싱. 트랙 순서와 공식 링크만 담은 메타데이터이고 상업 음원은 포함하지 않는다.
- 연출: 충돌 없이 물러나고 회전해 꽂히는 슬리브 핸드오프, 판지 재질의 이음새, 재생 중 톤암이 홈을 따라가는 움직임, Web Audio 분석기 기반 시각화. 감속 모션(reduced-motion)·키보드·터치를 지원한다.
- 음원 가져오기: Spotify 트랙·앨범·플레이리스트 메타데이터를 가져오고, 사용자가 소유권·권한을 명시적으로 확인한 경우에만 로컬
yt-dlp·FFmpeg로 신뢰도 높은 일치 항목을 자동 저장한다. 애매한 일치는 검토 큐에 남는다. 모든 데이터는 gitignore된.local-vinyl-library/에 저장된다. - 구조:
RecordShelfEngine.ts가 렌더러·카메라·애니메이션 루프를 단독 소유하고, 재생 상태는 순수 리듀서로 분리해 렌더 루프가 하나뿐이다.window.__VINYL_LIBRARY__.diagnostics()로 드로콜·충돌·오디오 밴드를 확인한다.
에이전트 도구와의 연결
.codex/config.toml에 Mint MCP 서버를, .agents/skills/에 Mint Three.js Skills를 벤더링해 두었고 OpenAI Sites 배포 메모가 있다. 즉 codex 같은 코딩 에이전트로 3D 웹앱을 만드는 쇼케이스 성격이 강하다. 비슷하게 에이전트로 만든 Three.js·3D 웹 작업은 2026-07-26-pytorchkr-topic-11410-img2threejs-three-js-3d, 2026-08-08-github-oso95-scroll-world 참고.
한계
- 라이선스 파일이 없어 재사용 조건이 불명확하다. 커버 이미지는 Cover Art Archive 출처로 각 권리자 소유라고 명시한다.
- 실행해 보지 않았고 README 내용만 정리했다.