Metadata-Version: 2.4
Name: spci-sonic-pulse
Version: 2.1.3
Summary: A CLI music player with YouTube streaming and offline support
License: MIT
Project-URL: Repository, https://github.com/ojaswi1234/music_player_cli.git
Project-URL: Issues, https://github.com/ojaswi1234/music_player_cli/issues
Keywords: music-player,cli,terminal,youtube,audio,rich-ui,sonic-pulse
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer
Requires-Dist: rich
Requires-Dist: requests
Requires-Dist: yt-dlp
Requires-Dist: ytmusicapi
Requires-Dist: tinydb
Dynamic: license-file

# SPCI - Sonic Pulse CLI Music Player

A powerful and lightweight command-line music player that lets you search, play, and manage your favorite music directly from your terminal.

## Features

- **Search:** Find music online.
- **Play:** Play songs instantly (checks offline favorites first).
- **Favorites:** Save songs locally for offline access.
- **History:** Keep track of your recently played tracks.
- **Rich UI:** Beautiful terminal interface powered by `rich`.

## Installation

```bash
pip install spci-sonic-pulse
```

### Prerequisites

- **Python 3.8+**
- **FFmpeg:** Required for processing audio streams (Don't worry if not there in your computer, the tool will auto download it or any alternative).


## Usage

Once installed, you can use the `spci` command:

```bash
# Search for music
spci search "Your Song Name"

# Play a song
spci play "Your Song Name"

# View favorites
spci show-fav

# View play history
spci show-history

```

## Commands

- `search`: Find music online.
- `play`: Play a song (checks offline first).
- `show-fav`: View and manage your offline favorites.
- `add-fav`: Add a song to your favorites.
- `delete-fav`: Remove a song from your favorites.
- `show-history`: Display playback history.
- `clear-history`: Clear your playback history.
- `setup`: Run initial configuration.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
