MusicTerm 0.0.4

play music from your termninal.

pymusicterm

pymusicterm is a terminal-based music player that allows you to play your favorite songs directly from your terminal. It only supports local files.

Features

• Play local music files.
• Download music from YouTube with pytubefix and ytmusicapi.
• Terminal-based interface powered by textual.
• Cross-platform support (Linux, macOS, Windows).
• MPRIS server integration for Linux to control playback with external tools.

Installation

Prerequisites

• Python 3.12 or higher.
• ffmpeg (required for pydub and audio processing).

You can install pymusicterm via pip:

Clone the repository:

git clone https://github.com/yourusername/pymusicterm.git
cd pymusicterm

Install dependencies:

pip install -r requirements.txt

Run the application:

python -m pymusicterm

Make sure all dependencies are met, including ffmpeg.

Basic Commands

• Play local files: Add the path to the file or directory.
• Download from YouTube: Search for a song or paste the URL.
• Control playback: Use keyboard shortcuts to play, pause, skip, or adjust volume.

Configuration

The player reads a configuration file (pymusicterm.toml) for custom settings in the ~/.pymusicterm directory.

Dependencies

pymusicterm relies on the following libraries:

• just-playback: Audio playback management.
• msgspec: High-performance serialization.
• pydub: Audio processing.
• pytubefix: Simplified YouTube streaming.
• textual: Terminal user interface framework.
• tomli-w: TOML configuration management.
• ytmusicapi: YouTube Music API integration.
• loguru: Advanced logging.
• mpris-server: MPRIS integration (Linux-only).

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature/bugfix.
3. Submit a pull request with a detailed explanation of changes.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

Enjoy your music in the terminal with pymusicterm!