https://github.com/h4wk507/tmplayer

Minimalist music player for audio files with a pleasant UI.
https://github.com/h4wk507/tmplayer

audio audio-player console music music-player python terminal

Last synced: 21 days ago
JSON representation

Minimalist music player for audio files with a pleasant UI.

• Host: GitHub
• URL: https://github.com/h4wk507/tmplayer
• Owner: H4wk507
• License: mit
• Created: 2023-03-17T23:42:59.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-06-08T20:26:53.000Z (over 1 year ago)
• Last Synced: 2024-09-14T16:23:07.730Z (2 months ago)
• Topics: audio, audio-player, console, music, music-player, python, terminal
• Language: Python
• Homepage:
• Size: 217 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# tmplayer

Minimalist music player for audio files with a pleasant UI.

![preview](./screenshots/preview.png)

## Installation

### PyPI

```

pip install tmplayer

```

### Manual

1. Clone the repository

```

git clone https://github.com/H4wk507/tmplayer.git

```

2. Go into the directory and install

```

cd tmplayer && pip install .

```

## Usage

Pass in directories/audio files as commandline arguments.

Example:

```

tmplayer ~/Music/Rap/ sample.mp3 ...

```

## Key bindings

- arrow keys: Navigate

- k and j: Move up and down

- enter: Play selected song

- space: Play/Pause

- n: Play the next song

- p: Play the previous song

- 1: Set default mode

- 2: Set loop mode

- 3: Set repeat mode

- r: Set random mode

- u: Increase volume by 5%

- d: Decrease volume by 5%

- q: Quit

## License

Licensed under the [MIT License](LICENSE).