/plsplay

A command line audio file player

Primary LanguageRustGNU General Public License v2.0GPL-2.0

PLSPLAY

A CLI audio file playing utility.

How to install

Download from AUR (Arch Linux)

With AUR helper (yay)

yay -S plsplay

Without AUR helper

git clone https://aur.archlinux.org/plsplay.git
cd plsplay
makepkg -si

Download from releases

Check the github releases and download the executable for your platform. If one isn't present then you must compile from source.

Compile from source

  1. Ensure you install cargo.

  2. Have make installed too.

  3. Clone the repo

     git clone https://github.com/el-wumbus/plsplay.git
 cd plsplay

  4. Compile & Install

     #COOL PEOPLE
 ./install.sh

 # Windows users
 ./install.ps1 # Not working yet, ok?

Calm down, it's a joke.

Usage

$ plsplay --help
plsplay 0.1.0

USAGE:
    plsplay [FLAGS] [OPTIONS] <file>

FLAGS:
    -d, --disable-terminal-controls    Disable interactive command line controls
    -h, --help                         Prints help information
    -t, --tui                          Use TUI instead of CLI
    -V, --version                      Prints version information

OPTIONS:
    -v, --volume <volume>    The playback volume (from 0 to 200) [default: 100]

ARGS:
    <file>    The audio file to play

Example

Without terminal controls

$ plsplay ~/cool_song.flac --volume 55 --disable-terminal-controls
Playing '/home/user/cool_song.flac' at 55% volume

With terminal controls

plsplay ~/cool_song.flac

image

With TUI

plsplay ~/cool_song.flac -t

image