HALKARA(1)

NAME ¶

halkara - command line player for Audius

SYNOPSIS ¶

halkara [options] [urls]

DESCRIPTION ¶

halkara is a simple command line player for Audius. If urls are specified as command line arguments, the tracks of the playlist/user/album (or the single track) will be played. If no urls are given, halkara will play the trending tracks.

The options are as follows:

-g, --genre genre

Selects the trending tracks for a specified genre

-h, --help

Print help information

--max-length

The maximum length for a track (longer tracks won't be played)

--min-length

The minimum length for a track (shorter tracks won't be played)

-o, --order order

The order in which to play the trending tracks [possible values: asc, desc, rand]

-t, --time range

Selects the trending tracks over a specified time range

--ui variant

The user interface variant to use [possible values: compact, log, ncurses]

-V, --version

Print the version information and exit.

--volume volume

The volume in dBFS

During runtime, halkara accepts commands from stdin to provide an interactive mode. Pressing enter after each of these commands is required to execute them.

The following commands are available:

q

Quit the application

<space>

Toggle between play and pause

+

Increase volume

-

Decrease volume

EXAMPLES ¶

The following command plays the trending tracks within the genre "Electronic" in descending order:

halkara --genre Electronic --order desc

To play all tracks uploaded by deadmau5, use the following command:

halkara https://audius.co/deadmau5

AUTHORS ¶

Created and maintained by Hannes Braun <hannes@hannesbraun.net>. Up-to-date sources can be found at https://git.sr.ht/~hannes/halkara. Bugs and patches can be submitted by email to ~hannes/public-inbox@lists.sr.ht.