piro0919
MCP Serverpiro0919public

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.

Repository Info

45
Stars
5
Forks
45
Watchers
1
Issues
TypeScript
Language
-
License

About This Server

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.

Model Context Protocol (MCP) - This server can be integrated with AI applications to provide additional context and capabilities, enabling enhanced AI interactions and functionality.

Documentation

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

FeatureDescription
🔄 Play / PauseSpacebar or click anywhere
⏹ StopResets to beginning
↔ SeekArrow keys, or click-and-drag slider
🔊 Volume controlMouse or keyboard ↑↓ keys
🔁 Playlist supportMultiple file queue with looping
🖱 Drag & Dropor click to open local files
⌨️ File Open ShortcutO via menu or hotkey
🖥 Fullscreen toggleF key or button (with icon change)
💾 Persistent stateVolume & window size remembered
🎵 Audio supportSupports .mp3, .m4a, .wav, etc.
❓ Keyboard Shortcuts Help? key to toggle overlay
🧾 Track Info Overlayi key or button to toggle metadata
🔢 Percentage Seek09 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 start

📸 Preview

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

📝 License

MIT — Feel free to fork and extend!


🙌 Credits

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

Inspired by Media Player Classic

Quick Start

1

Clone the repository

git clone https://github.com/piro0919/mac-classic-player
2

Install dependencies

cd mac-classic-player
npm install
3

Follow the documentation

Check the repository's README.md file for specific installation and usage instructions.

Repository Details

Ownerpiro0919
Repomac-classic-player
LanguageTypeScript
License-
Last fetched8/10/2025

Recommended MCP Servers

💬

Discord MCP

Enable AI assistants to seamlessly interact with Discord servers, channels, and messages.

integrationsdiscordchat
🔗

Knit MCP

Connect AI agents to 200+ SaaS applications and automate workflows.

integrationsautomationsaas
🕷️

Apify MCP Server

Deploy and interact with Apify actors for web scraping and data extraction.

apifycrawlerdata
🌐

BrowserStack MCP

BrowserStack MCP Server for automated testing across multiple browsers.

testingqabrowsers

Zapier MCP

A Zapier server that provides automation capabilities for various apps.

zapierautomation