Skip to content

piro0919/mac-classic-player

Repository files navigation

App icon Mac Classic Player

A lightweight, keyboard-friendly media player for macOS — inspired by Media Player Classic. This player offers a rich set of keyboard shortcuts for enhanced control and accessibility.


Mac Classic Player (a.k.a MCP) is a minimalist and responsive video and audio player built for macOS, featuring:

  • 🎥 MPC-inspired UI
  • ⌨️ Full keyboard control (seek, volume, fullscreen, playlist, help, and more)
  • 🧭 Drag & drop or one-click file loading
  • 💾 Auto-save volume and window size
  • 🖥 Native .mov, .mp4, .webm, and audio formats like .mp3, .m4a, .wav support (with .hevc planned)

🚀 Features

Feature Description
🔄 Play / Pause Spacebar or click anywhere
⏹ Stop Resets to beginning
↔ Seek Arrow keys, or click-and-drag slider
🔊 Volume control Mouse or keyboard ↑↓ keys
🔁 Playlist support Multiple file queue with looping
🖱 Drag & Drop or click to open local files
⌨️ File Open Shortcut O via menu or hotkey
🖥 Fullscreen toggle F key or button (with icon change)
💾 Persistent state Volume & window size remembered
🎵 Audio support Supports .mp3, .m4a, .wav, etc.
❓ Keyboard Shortcuts Help ? key to toggle overlay
🧾 Track Info Overlay i key or button to toggle metadata
🔢 Percentage Seek 09 keys to jump to 0%–90%

🛠 Installation

⬇ Download the latest version

Or build it locally:

git clone https://github.com/piro0919/mac-classic-player
cd mac-classic-player
npm install
npm run dev

📸 Preview

Screenshot: video playing Screenshot: audio file playback
Screenshot: shortcuts overlay Screenshot: empty startup
Screenshot: track info overlay

📝 License

MIT — Feel free to fork and extend!


🙌 Credits

Built with ❤️ using Tauri, React, and lucide-react

Inspired by Media Player Classic

About

A lightweight, keyboard-friendly media player for macOS — inspired by Media Player Classic

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Contributors