-
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathmpdplaylist.1
190 lines (135 loc) · 4.95 KB
/
mpdplaylist.1
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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
.\" vim: tw=75
.TH mpdplaylist 1
.SH NAME
mpdplaylist \- Generate playlist for Music Player Daemon
.SH SYNOPSYS
.B mpdplaylist
[
.I options
]
.SH DESCRIPTION
\fBmpdplaylist\fR(1) is a shell frontend for generating playlists for Music
Player Daemon. It has many options to help you chose a playlist based on
tracks played by you using \fBmpd\fR(1). It uses the stats.db \fBsqlite\fR
database generated by \fBmpdev\fR(1) and the ratings maintained in the
sticker database for mpd.
\fBmpdplaylist\fR(1) displays the result on stdout. You can redirect the
output to any filename with m3u extension. You can also use --playlist
option tosave the result to a playlist in the mpd(1)
\fIplaylist_directory\fR configured in mpd.conf(5).
If no options are given, \fBmdplaylist\fR can use the file
$HOME/.mpdplaylist.options to use default options. You can use
--options-file=\fIfile\fR to load options from \fIfile\fR
.SH OPTIONS
Known values for OPTION are:
.EX
--options-file=filename
Take extra command line options from filename
--fromyear=From Year
Year in YYYY format
--toyear=To Year
Year in YYYY format
--includegenre=Genre List to be included
comma separated list of genre.
--excludegenre=Genre List to be excluded
comma separated list of genre
--includeartist=Artist List to be included
comma separated list of artist.
--excludeartist=Artist List to be excluded
comma separated list of artist
--minrating=Minimum Rating (value from 0 to 10, or -1 for unrated songs)
--artist=Artist
Find songs with Artist exactly matching 'Artist'
--artistany=keyword
Find songs with Artist having 'keyword' anywhere in the Artist field
--new=d
Find songs added in the last 'd' days
--daysheard=d
Find songs heard in the last 'd' days
--daysnotheard=d
Find songs not heard in the last 'd' days, use d=0 for songs never played
--oldfirst
Order playlist in ascending order of Last Played field
(Song played earlier come at top)
--popular
Order playlist in decreasing order of Rating field
(Songs with high rating come at top)
--karma
Find songs with karma as per expression. e.g.
--karma<50 means songs with karma less than 50
--karma<=50 means songs with karma less than or equal to 50
--karma=50 means songs with karma equal to 50
--karma>=50 means songs with karma greater than or equal to 50
--karma>50 means songs with karma greater than 50
--playcount=exp
Find songs with playcounts as per expression. e.g.
--playcount<5 means songs with play counts less than 5
--playcount<=5 means songs with play counts less than or equal to5
--playcount=5 means songs with play counts equal to 5
--playcount>=5 means songs with play counts greater than or equal to 5
--playcount>5 means songs with play counts greater than 5
--playlist=playlist
save the playlist in the filename $playlist_dir/playlist.
If the playlist is named now, new playlist will be added to the
current mpd playlist. If --clear is also specified, the current
playlist will be cleared and loaded. The 'now' playlist is not
saved to the playlist directory. Without --playlist option,
result will be displayed on screen.
--host=host
mpd host to use
--shuffle
shuffle playlist
--limit=n
Limit the playlist to n entries
--play
Play songs when playlist=now
--clear
clear playlist before adding. See --playlist option
--query
Display the SQL query and exit
--help
display this help and exit
--version
output version information
.EE
.SH EXAMPLES
.EX
Load a playlist as defined in ~/.mpdplaylist.options
\fBmpdplaylist\fR
Load a playlist as defined in ~/.mpdplaylist.new
\fBmpdplaylist\fR --options-file=~/.mpdplaylist.new
List all songs added in the last 3 days
\fBmpdplaylist\fR --new=3
List all songs belonging to \fIHindi\fR genre, having a rting of 6 &
greater (on a scale of 10), from the year 1970 to the year 2000. Sort the
result on the \fIlast_played\fR field in ascendning order and in descending
order of the \fIrating\fR field.
\fBmpdplaylist\fR --fromyear=1970 --toyear=2000 --includegenre="Hindi" \
--minrating=6 --oldfirst --popular
List all songs in the genre 'Heavy Metal' and 'Hard Rock', added in the
last 30 days
\fBmpdplaylist\fR --includegenre="Heavy Metal, Hard Rock" --new=30
List all songs heard in the last 10 days
\fBmpdplaylist\fR --daysheard=10
List all songs not heard in the last 20 days
\fBmpdplaylist\fR --daysnotheard=20
List all songs which have never been heard
\fBmpdplaylist\fR --daysnotheard=0
List all songs added in the last 1 year but have never been heard
\fBmpdplaylist\fR --new=365 --daysnotheard=0
List all songs not heard in the last 20 days order by last played with the
last played at top
\fBmpdplaylist\fR --oldfirst --daysnotheard=20
Save the output in the mpd playlist new
\fBmpdplaylist\fR --includegenre="Heavy Metal, Hard Rock" --new=30 --playlist=new
.EE
.SH RETURN VALUE
\fBmpdplaylist\fR returns non-zero status on error.
.SH "SEE ALSO"
mpd(1),
mpc(1),
mpd.conf(5),
mpdev_update(1),
mpdev_cleanup(1),
mpdev(1),
sqlite3(1)