loading…
Search for a command to run...
loading…
Ai friendly CLI music player
Ai friendly CLI music player
PyPI version License: GPL v3 Python 3.7+
The Fire-and-Forget Music Player for Developers.
Yit is a lightweight, headless, terminal-based audio player designed for flow states. It allows you to search, queue, and control music directly from your CLI without ever touching a browser or a heavy GUI.
It runs in the background (daemonized), meaning you can close your terminal, switch tabs, or keep coding while the music plays.
yt-dlp to fetch metadata in milliseconds.add, next, back, Loop) with simple commands.pip install yit-player
mpv audio engine internally. mpv.exe if missing.brew or apt if needed).If you run yit and get an error, your Python scripts folder is not in your system PATH.
Solution: Run it like this instead (works 100% of the time):
python -m yit search "slava funk" -p
# Search for a song
yit search "funk sigilo"
# Auto-play the first result immediately
yit search "funk infernal" -p
yit pause # (or 'p')
yit resume # (or 'r')
yit toggle # Toggle play/pause
yit stop # Kill the player
yit add 1 # Add result #1 from your last search to the queue (use 1 - 5 to choose from search results)
yit queue # Show the current queue
yit next # Skip track (or 'n')
yit back # Previous track (or 'b')
yit clear # Wipe the queue
yit loop # Loop the current track indefinitely
yit unloop # Return to normal playback
yit status # Check if currently Playing/Paused and Looped
Save your best tracks for later.
# list all favorites
yit fav
# Add to favorites
yit fav add # Add the CURRENTLY playing song
yit fav add 1 # Add result #1 from your last search
# Play favorites
yit fav play # Play ALL favorites (starting from #1)
yit fav play 3 # Play favorite #3
# Remove
yit fav remove 2 # Remove favorite #2
Yit is designed to be self-documenting for AI context. If you are building an AI agent or using an LLM in your IDE:
yit commands to get a JSON list of all capabilities.yit agent to get the full player state (Track, Time, Queue) in pure JSON.Example Agent Output (yit agent):
{
"status": "playing",
"track": {
"title": "Never Gonna Give You Up",
"url": "https://..."
},
"position": 45.2,
"duration": 212.0,
"queue_length": 5
}
Yit includes a built-in Model Context Protocol (MCP) server (yit-mcp). You can easily connect Yit to any supported AI IDE or desktop agent.
Add the following JSON configuration block to your client's MCP config file (e.g., mcp_config.json):
{
"mcpServers": {
"yit-player": {
"command": "yit-mcp",
"args": [],
"env": {},
"disabled": false
}
}
}
yit) handles argument parsing and user signals.mpv process handles audio decoding and network streaming.~/.yit/history.json stores your playback history and queue metadata.1. Educational Purpose Only
This software (Yit) is a proof-of-concept project designed strictly for educational and research purposes. Its primary goal is to demonstrate:
2. Third-Party Content
This tool acts as a command-line interface (CLI) wrapper for open-source media engines (mpv) and network libraries (yt-dlp).
3. Terms of Service Users are responsible for ensuring their use of this tool complies with the Terms of Service of any third-party platforms they interact with. The developer of this tool assumes no liability for misuse, account suspensions, or legal consequences arising from the use of this software.
4. No Monetization This project is free and open-source. It is not monetized in any way, nor does it generate revenue from the content it accesses.
This project is licensed under the GNU General Public License v3.0 (GPLv3). This ensures the software remains free and open-source. Commercial distribution of this software as a closed-source product is strictly prohibited.
For any questions, please contact [email protected].
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"yit-player": {
"command": "npx",
"args": []
}
}
}