« get me outta code hell

Merge branch 'master' of https://github.com/liam4/http-music - http-music - Command-line music player + utils (not a server!)
about summary refs log tree commit diff
path: root/man/http-music-crawl-itunes.1
diff options
context:
space:
mode:
authorLiam <towerofnix@gmail.com>2017-07-13 14:34:11 +0000
committerLiam <towerofnix@gmail.com>2017-07-13 14:34:11 +0000
commitd25c15797741e92e35ad3f43b8b827811e6d4ca7 (patch)
tree71879c23e2b554770ef3ee5cde3392d2cf812dff /man/http-music-crawl-itunes.1
parentc52550d2b448eeaab098525ec431e341f8a97b29 (diff)
parent27704d39664b711ae110f9beb708afb7dcaf4dc5 (diff)
Merge branch 'master' of https://github.com/liam4/http-music
Diffstat (limited to 'man/http-music-crawl-itunes.1')
-rw-r--r--man/http-music-crawl-itunes.125
1 files changed, 25 insertions, 0 deletions
diff --git a/man/http-music-crawl-itunes.1 b/man/http-music-crawl-itunes.1
new file mode 100644
index 0000000..9d21734
--- /dev/null
+++ b/man/http-music-crawl-itunes.1
@@ -0,0 +1,25 @@
+.TH http-music-crawl-itunes 1
+
+.SH NAME
+http-music-crawl-itunes - create a playlist file using an iTunes library
+
+.SH SYNOPSIS
+.B http-music-crawl-itunes
+[libraryPath]
+
+.SH DESCRIPTION
+\fBhttp-music-crawl-itunes\fR is a command line utility used to generate a
+playlist file for usage with \fBhttp-music\fR using the Apple iTunes library
+XML format.
+
+It requires the iTunes XML format; this is not the usual iTunes Library.itl format, but it is officially supported by Apple (though not used in recent Apple software).
+This iTunes XML file is automatically generated by iTunes if the \fB"Share iTunes Library XML with other applications"\fR option is checked in the advanced preferences section of iTunes.
+If this option is not checked (which is the case, by default), it must be enabled for crawl-itunes to function.
+
+The path for the iTunes XML library file may be passed as an argument; if not given, it is assumed to be \fB~/Music/iTunes/iTunes Music Library.xml\fR.
+
+The resulting playlist file is sorted as a hierarchial tree formed of a group for each artist and then a group for each of the artists' albums.
+See the \fBEXAMPLES\fR section of \fBhttp-music\fR (1) for information on filtering to a specific artist or album.
+
+.SH SEE ALSO
+For more information on the iTunes Library XML file: \fIhttps://support.apple.com/en-ca/HT201610\fR