musix 0.3.2

Music player library for esoteric audio formats (music from C64,Amiga etc)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

Musix player
============

```

➜  msxp music/C64/Last_Ninja_2.sid
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Last Ninja 2 / Matt Gray                                       ┃
┃ The Street (loader)                                            ┃
┣━━━━━━━━━━━━━━━┳━━━━━━┳━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┫
┃ 00:27 / 05:03 ┃ SONG ┃ 03/13 ┃ FORMAT ┃ SID (C64)              ┃
┗━━━━━━━━━━━━━━━┻━━━━━━┻━━━━━━━┻━━━━━━━━┻━━━━━━━━━━━━━━━━━━━━━━━━┛
```

### Building & Running

```
make
build/msxp music/Warhawk.sap
```

### Installing

Copy `msxp` to your path and the `data` directory as
`/usr/local/share/musix` or `~/.local/share/musix`
(Or keep the `data` directory alongside the executable).

### Using

`msxp [options] <musicfiles ...>`

* `-d` run in background
* `-n` play next file
* `-p` play previous file
* `-s <no>` Set subsong
* `-o` Write audio to stdout
* `-q` Quit background player
* `-a` Add files to queue instead of replacing queue

### Text UI

* `[ENTER]` / `[BACKSPACE]` for next/previous file
* `[LEFT]` / `[RIGHT]` for sub song
* `[ESC]` to detach and keep playing
* `q` to quit

(Run without file arguments to activate UI again)

### Converting to MP3

`msxp -o <file> | lame -r file.mp3`

### Playing multiple files
(Examples require downloaded copy of MODLAND :)


Play all tracked music by Purple Motion
```
fd ".(mod|xm|s3m)$" ~/MODLAND/*/Purple\ Motion | msxp && msxp -c
```

Play all tracked music in (~134K files) and shuffle it

```
fd ".(mod|xm|s3m)$" ~/MODLAND | sort -R | msxp
```

### LUA & Themes

Copy `data/example.lua` to `~/.config/musix/init.lua` and edit it to change
the theme etc. (TBC).