| Name | cmusic JSON |
| Version |
1.2.0
JSON |
| download |
| home_page | None |
| Summary | the CLI music player |
| upload_time | 2024-08-23 17:42:48 |
| maintainer | None |
| docs_url | None |
| author | Kokonico |
| requires_python | <4.0,>=3.12 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# cMusic
> A simple CLI music player written in Python.
## NOTICE
Although this player can play any audio file, *I do not condone piracy.* Please only use this player to play music that you own or have the rights to play. By using this player, you agree to take full responsibility for any legal consequences that may arise from your use of this player.
## Table of Contents
- [Notice](#notice)
- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [Music Controls](#music-controls)
- [Commands](#commands)
- [Background Mode Commands](#background-mode-commands)
- [Playlist Commands](#playlist-commands)
## Requirements
- Python 3.12+ & dependencies (should be installed automatically)
- poetry
- tmux
## Installation
cmusic is available on PyPI, so you can install it using pip.
```sh
pip install cmusic
```
(please make sure that your python scripts directory is in your PATH)
or you can install it from the source code.
```sh
git clone https://github.com/Kokonico/cMusic
cd cmusic
pip3.12 install .
```
<!-- not implemented yet. -->
<!--
or if you're on macOS, you can use Homebrew to install it.
```sh
brew tap Kokonico/tap
brew install cmusic
```
-->
## Usage
Cmusic currently only supports mp3 files. To use the player, you need to index the songs you want to play first.
```sh
# index a song
cmusic index <Song File>
```
example:
```sh
cmusic index "path/to/song.mp3"
```
it will walk you through the process of indexing the song.
to select options to change, use arrow keys to navigate and space to select.
to play a song, you can use the following command, the name of the song should be the same as the one you set when indexing the song.
```sh
cmusic play <Song> [--loop] [--shuffle]
```
_pssst, you can also pass multiple Songs to play them in a row._
```sh
cmusic play <Song1> <Song2> <Song3> ...
```
The player will display the current Song playing, the progress of the Song and the controls.
```
NOW PLAYING: Altars of Apostasy by Heaven Pierce Her (Ultrakill: Imperfect Hatred (Original Game Soundtrack))
─────────█────────────────────
<< || >> 01:44 / 05:37 ────○ 🔊 100% 🔁
```
if you want, you can activate background mode by adding the `--background` flag to the command.
```sh
cmusic play <Song> --background
```
it will play the Song in the background, and you can continue using the terminal.
note: if you want to return to the player, you can use `cmusic c`
### Music Controls
to control the music when it's not in the background, you can use the following keys:
- `space` to pause/play the Song.
- `s` to skip the current song
- `shift + (+)` to increase the volume.
- `shift + (-)` to decrease the volume.
- `e` to enter background mode.
### commands
- `cmusic index <Song File>` to index a Song
- `cmusic list` to list all the songs in the library.
- `cmusic play <Song>` to play a Song.
- `cmusic version` to display the version of the player.
- `cmusic search <query>` to search for Songs in the library.
- `cmusic del <Song>` to delete a song.
<!-- - `cmusic queue <Song>` to add a Song to the queue. it'll play after the one currently playing. -->
#### background mode commands
- `cmusic p` to pause/play the current Song
- `cmusic v <volume>` to change the volume of the player.
- `cmusic c` to return to the player.
- `cmusic q` to quit the player.
#### playlist commands
- `cmusic playlist create <name> <song>(s)` to create a playlist.
- `cmusic playlist add <name> <song>(s)` to add a Song to a playlist.
- `cmusic playlist remove <name> <song>(s)` to remove a Song from a playlist.
- `cmusic playlist delete <name>` to delete a playlist.
- `cmusic playlist list` to list all the playlists.
- `cmusic playlist list <name>` to list all the Songs in a playlist.
- `cmusic play <playlist name> --playlist` to play a playlist.
## Development setup
To set up the development environment, you need to have Poetry and python 3.12+ installed on your system.
```sh
git clone https://github.com/Kokonico/cMusic
cd cmusic
poetry install
```
to install the player to use it in the terminal, you can use the following command.
```sh
poetry run pip install .
```
## License
This project is licensed under the Zlib License. See the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "cmusic",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.12",
"maintainer_email": null,
"keywords": null,
"author": "Kokonico",
"author_email": "kokonico@duck.com",
"download_url": "https://files.pythonhosted.org/packages/f1/62/56e05defd3ab545feb3ca0262537e8b38beeaedf210269dac191eab94d85/cmusic-1.2.0.tar.gz",
"platform": null,
"description": "# cMusic\n> A simple CLI music player written in Python.\n\n## NOTICE\nAlthough this player can play any audio file, *I do not condone piracy.* Please only use this player to play music that you own or have the rights to play. By using this player, you agree to take full responsibility for any legal consequences that may arise from your use of this player.\n\n## Table of Contents\n- [Notice](#notice)\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Usage](#usage)\n - [Music Controls](#music-controls)\n - [Commands](#commands)\n - [Background Mode Commands](#background-mode-commands)\n - [Playlist Commands](#playlist-commands)\n\n## Requirements\n- Python 3.12+ & dependencies (should be installed automatically)\n- poetry\n- tmux\n\n## Installation\n\ncmusic is available on PyPI, so you can install it using pip.\n\n```sh\npip install cmusic\n```\n\n(please make sure that your python scripts directory is in your PATH)\n\nor you can install it from the source code.\n\n```sh\ngit clone https://github.com/Kokonico/cMusic\ncd cmusic\npip3.12 install .\n```\n\n<!-- not implemented yet. -->\n<!--\nor if you're on macOS, you can use Homebrew to install it.\n\n```sh\nbrew tap Kokonico/tap\nbrew install cmusic\n```\n-->\n\n## Usage\n\nCmusic currently only supports mp3 files. To use the player, you need to index the songs you want to play first.\n\n```sh\n# index a song\ncmusic index <Song File>\n```\n\nexample:\n\n```sh\ncmusic index \"path/to/song.mp3\"\n```\n\nit will walk you through the process of indexing the song.\n\nto select options to change, use arrow keys to navigate and space to select.\n\nto play a song, you can use the following command, the name of the song should be the same as the one you set when indexing the song.\n\n```sh\ncmusic play <Song> [--loop] [--shuffle]\n\n```\n\n_pssst, you can also pass multiple Songs to play them in a row._\n\n```sh\ncmusic play <Song1> <Song2> <Song3> ...\n```\n\nThe player will display the current Song playing, the progress of the Song and the controls.\n```\nNOW PLAYING: Altars of Apostasy by Heaven Pierce Her (Ultrakill: Imperfect Hatred (Original Game Soundtrack))\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2588\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n<< || >> 01:44 / 05:37 \u2500\u2500\u2500\u2500\u25cb \ud83d\udd0a 100% \ud83d\udd01\n```\n\n\nif you want, you can activate background mode by adding the `--background` flag to the command.\n```sh\ncmusic play <Song> --background\n```\nit will play the Song in the background, and you can continue using the terminal.\n\nnote: if you want to return to the player, you can use `cmusic c`\n\n\n### Music Controls\n\nto control the music when it's not in the background, you can use the following keys:\n- `space` to pause/play the Song.\n- `s` to skip the current song\n- `shift + (+)` to increase the volume.\n- `shift + (-)` to decrease the volume.\n- `e` to enter background mode.\n\n### commands\n\n- `cmusic index <Song File>` to index a Song\n- `cmusic list` to list all the songs in the library.\n- `cmusic play <Song>` to play a Song.\n- `cmusic version` to display the version of the player.\n- `cmusic search <query>` to search for Songs in the library.\n- `cmusic del <Song>` to delete a song.\n<!-- - `cmusic queue <Song>` to add a Song to the queue. it'll play after the one currently playing. -->\n\n#### background mode commands\n\n- `cmusic p` to pause/play the current Song\n- `cmusic v <volume>` to change the volume of the player.\n- `cmusic c` to return to the player.\n- `cmusic q` to quit the player.\n\n#### playlist commands\n\n- `cmusic playlist create <name> <song>(s)` to create a playlist.\n- `cmusic playlist add <name> <song>(s)` to add a Song to a playlist.\n- `cmusic playlist remove <name> <song>(s)` to remove a Song from a playlist.\n- `cmusic playlist delete <name>` to delete a playlist.\n- `cmusic playlist list` to list all the playlists.\n- `cmusic playlist list <name>` to list all the Songs in a playlist.\n- `cmusic play <playlist name> --playlist` to play a playlist.\n\n## Development setup\n\nTo set up the development environment, you need to have Poetry and python 3.12+ installed on your system.\n\n```sh\ngit clone https://github.com/Kokonico/cMusic\ncd cmusic\npoetry install\n```\n\nto install the player to use it in the terminal, you can use the following command.\n\n```sh\npoetry run pip install .\n```\n\n## License\n\nThis project is licensed under the Zlib License. See the [LICENSE](LICENSE) file for details.\n \n",
"bugtrack_url": null,
"license": null,
"summary": "the CLI music player",
"version": "1.2.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5023c3077c63d671c06a762ea30d69c64d0cb8f8c027727b6d522389bdc93aae",
"md5": "51a8d018ca7140b6bf3b83fd0126dbe5",
"sha256": "2e70168a0d499e308fe3619b6163366578c2343bb0b28956f585c2f54ddf05e5"
},
"downloads": -1,
"filename": "cmusic-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "51a8d018ca7140b6bf3b83fd0126dbe5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.12",
"size": 19519,
"upload_time": "2024-08-23T17:42:46",
"upload_time_iso_8601": "2024-08-23T17:42:46.482762Z",
"url": "https://files.pythonhosted.org/packages/50/23/c3077c63d671c06a762ea30d69c64d0cb8f8c027727b6d522389bdc93aae/cmusic-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f16256e05defd3ab545feb3ca0262537e8b38beeaedf210269dac191eab94d85",
"md5": "dc90bd6b8ce81fd1cbbad3a1aef60fdf",
"sha256": "7985f77953a7c780ebe6daf8c482a84b8e821a7f9cf5b48061307ee7298c84a7"
},
"downloads": -1,
"filename": "cmusic-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "dc90bd6b8ce81fd1cbbad3a1aef60fdf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.12",
"size": 18326,
"upload_time": "2024-08-23T17:42:48",
"upload_time_iso_8601": "2024-08-23T17:42:48.193800Z",
"url": "https://files.pythonhosted.org/packages/f1/62/56e05defd3ab545feb3ca0262537e8b38beeaedf210269dac191eab94d85/cmusic-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-23 17:42:48",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "cmusic"
}
