apple-music-tui

Crates.ioapple-music-tui
lib.rsapple-music-tui
version0.2.3
created_at2026-01-20 00:48:51.019856+00
updated_at2026-01-21 12:45:54.052498+00
descriptionA TUI remote controller for macOS Music.app
homepagehttps://github.com/ori0o0p/apple-music-tui
repositoryhttps://github.com/ori0o0p/apple-music-tui
max_upload_size
id2055573
size95,629
Seungwon (ori0o0p)

documentation

README

🎡 Apple Music TUI

macOS Music.app을 ν„°λ―Έλ„μ—μ„œ μ œμ–΄ν•˜λŠ” TUI (Terminal User Interface) 리λͺ¨νŠΈ 컨트둀러

macOS Rust Crates.io

✨ μ£Όμš” κΈ°λŠ₯

  • 🎨 앨범 μ•„νŠΈμ›Œν¬ ν‘œμ‹œ - ν„°λ―Έλ„μ—μ„œ 앨범 컀버 이미지 λ Œλ”λ§
  • ▢️ μž¬μƒ μ œμ–΄ - μž¬μƒ/μΌμ‹œμ •μ§€, 이전/λ‹€μŒ 곑
  • πŸ”Š λ³Όλ₯¨ 쑰절 - ν„°λ―Έλ„μ—μ„œ λ°”λ‘œ λ³Όλ₯¨ μ—…/λ‹€μš΄
  • πŸ“Š μ‹€μ‹œκ°„ 진행 λ°” - ν˜„μž¬ μž¬μƒ μœ„μΉ˜ ν‘œμ‹œ
  • ⌨️ Vim μŠ€νƒ€μΌ ν‚€ 바인딩 - h/j/k/l 지원

μ„€μΉ˜

crates.io (ꢌμž₯)

cargo install apple-music-tui

μ†ŒμŠ€μ—μ„œ λΉŒλ“œ

git clone https://github.com/ori0o0p/apple-music-tui.git
cd apple-music-tui
cargo build --release

μ‚¬μš©λ²•

  1. Music.app을 λ°±κ·ΈλΌμš΄λ“œμ—μ„œ μ‹€ν–‰
  2. ν„°λ―Έλ„μ—μ„œ μ•± μ‹€ν–‰:
apple-music-tui
# λ˜λŠ” μ†ŒμŠ€μ—μ„œ λΉŒλ“œν•œ 경우
cargo run --release

πŸ’‘ 팁: iTerm2, Kitty, WezTerm λ“± κ·Έλž˜ν”½μŠ€ ν”„λ‘œν† μ½œμ„ μ§€μ›ν•˜λŠ” ν„°λ―Έλ„μ—μ„œ 더 μ„ λͺ…ν•œ 앨범 μ•„νŠΈμ›Œν¬λ₯Ό λ³Ό 수 μžˆμŠ΅λ‹ˆλ‹€.

ν‚€ 바인딩

ν‚€ λ™μž‘
Space μž¬μƒ / μΌμ‹œμ •μ§€
← / h 이전 곑
β†’ / l λ‹€μŒ 곑
↑ / k λ³Όλ₯¨ 증가 (+5)
↓ / j λ³Όλ₯¨ κ°μ†Œ (-5)
q / Esc μ’…λ£Œ

μŠ€ν¬λ¦°μƒ·

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚πŸŽ΅ Apple Music Remote                                         β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”                                           β”‚
β”‚β”‚                β”‚  Title:  Colorful                         β”‚
β”‚β”‚   [ARTWORK]    β”‚  Artist: tripleS                          β”‚
β”‚β”‚                β”‚  Album:  ASSEMBLE                         β”‚
β”‚β”‚                β”‚  β–Ά Playing                                β”‚
β”‚β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜                                           β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Progress  [β–“β–“β–“β–“β–“β–“β–“β–“β–‘β–‘β–‘β–‘β–‘β–‘β–‘β–‘]  02:30 / 04:15                β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Volume    [β–“β–“β–“β–“β–“β–“β–“β–‘β–‘β–‘β–‘β–‘β–‘β–‘β–‘β–‘]  65%                          β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ ␣ Play/Pause  ←/β†’ Prev/Next  ↑/↓ Volume  q Quit            β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

μš”κ΅¬μ‚¬ν•­

  • macOS (Music.app μ‚¬μš©)
  • Rust 1.70+
  • Music.app이 λ°±κ·ΈλΌμš΄λ“œμ—μ„œ μ‹€ν–‰ 쀑이어야 함

기술 μŠ€νƒ

  • ratatui - TUI ν”„λ ˆμž„μ›Œν¬
  • ratatui-image - 터미널 이미지 λ Œλ”λ§
  • tokio - 비동기 λŸ°νƒ€μž„
  • crossterm - 터미널 μ œμ–΄
  • JXA (JavaScript for Automation) - Music.app 톡신
  • iTunes Search API - 앨범 μ•„νŠΈμ›Œν¬ κ°€μ Έμ˜€κΈ°

λΌμ΄μ„ μŠ€

MIT

Commit count: 23

cargo fmt