~moody/mpl

mpl/mpl.1 -rw-r--r-- 2.5 KiB
7309e0f2 — Jacob Moody Archive and point to zuke 6 months ago
                                                                                
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
.TH MPL 1
.SH NAME
mpl \- music player
.SH SYNOPSIS
.B mpl
[
.B -m
.I library
]
.br
.B mpl
[
.B -s
.I album
]
.br
.B mpl
[
.B -r
.I radio
]
.br
.B mpl
[
.B -p
.I playlist
]
.br
.B mpl
[
.B -f
.I file
]
.SH DESCRIPTION
.I mpl
is a graphical music player.
.I mpl
will gather meta information from audio files
by reading ID3v1 or FLAC meta information
stored in the files.
.I mpl
will search audio files for embeded cover art
as well as cover image files within the album
directory.
.br
.I mpl
has 5 exclusive modes for initalizing the playlist.
.TF -rmachine
.TP
.B -m
Multi. This will load many albums from a directory containing one
album per child directory.
.TP
.B -s
Single. This will load a single album directory.
.TP
.B -r
Radio. This will initialize the playlist to follow a
.IR hubfs(1)
.I radio
file.
.I mpl
will expect there to be an updating
.I playing
file under the same directory to read the current song.
.TP
.B -f
File. This will load a single audio file.
.TP
.B -p
Playlist. This will load from a
.I .list
file stored under the mpl directory
stored in
.B $home/lib/mpl.
.PD
.SS Player controls
.TF -rmachine
.TP
.B Del
Exit the program.
.TP
.B S
Toggle the sidebar playlist view.
.TP
.B P
Pause the current song.
.TP
.B L
Resume the current song.
.TP
.B N
Skip to the next song in the album.
.TP
.B M
Skip backwards to the previous song in the album.
.TP
.B 9
Increase volume.
.TP
.B 0
Decrease volume.
.TP
.B D
Dump the current playlist to a
.I .list
and
.I .db
file.
.TP
.B O
Open a playlist under the playlist directory by name.
.PD
Additionally users can change the current song and playlist
by clicking the name.
.SS Playlist File Format
.I mpl
uses two different file formats:
.br
.I .db
files are used internally for caching meta information
for a matching playlist and should not be edited by the user.
.br
.I .list
files can be writen by the user and placed in
.B $home/lib/mpl.
Each list file can contain one or more albums. Albums are defined as
the album name followed by a newline, then the path of each song seperated
by a newline. Albums are seperated by two newlines following the last song.
Once the playlist has been loaded, the user can issue the 
.B dump
command to generate a
.I .db
cache of the meta information.
.B dump
will also generate or update a
.I .list
file for the current playlist.
.SH DIAGNOSTICS
When using the
.B radio
option, the current playing file and the
name displayed may become out of sync.
.SH SOURCE
https://github.com/majiru/mpl
.SH BUGS
Quite possibly.
.SH SEE ALSO
.IR juke(7),
.IR playlistfs(7)