'\" t
.\"     Title: music-collection
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 12/28/2018
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "MUSIC\-COLLECTION" "1" "12/28/2018" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
music-collection \- synchronizes a music collection
.SH "SYNOPSIS"
.sp
music\-collection [options] source_dir target_dir
.SH "DESCRIPTION"
.sp
This script synchronizes a music collection recursively one way from a lossless format source directory to a lossy file format target directory\&.
.SH "OPTIONS"
.PP
\fI\-h, \-\-help\fR
.RS 4
show this help message and exit
.RE
.PP
\fI\-l LOGLEVEL, \-\-loglevel=LOGLEVEL\fR
.RS 4
set\(cqs the log level (ie\&. the amount of output) possible values: DEBUG, INFO, WARNING, ERROR, CRITICAL
.RE
.PP
\fI\-f FORMAT, \-\-format=FORMAT\fR
.RS 4
set the target format to mp3 or ogg (default is mp3)
.RE
.PP
\fI\-w, \-\-target_win\fR
.RS 4
convert the filenames to Windows convention (for example if you copy to a FAT Partition)
.RE
.PP
\fId, \-\-no_donation\fR
.RS 4
suppress the donation message\&.
.RE
.PP
\fIs, \-\-followlinks\fR
.RS 4
By default the script will not walk down into symbolic links that resolve to directories\&. Set followlinks to visit directories pointed to by symlinks, on systems that support them\&.
\fIr, \-\-resample\fR
resample to 44\&.1KHz when converting
.RE
.PP
\fIm, \-\-multiprocess\fR
.RS 4
use multiprocessing to convert the files (default is false)
.RE
.PP
\fIp NUMBEROFPROCESSES, \-\-numberofprocesses=NUMBEROFPROCESSES\fR
.RS 4
set the number of processes used to convert the files, ignored if multiprocess option is not active (default is the number of detected CPUs)
.RE
.SH "DETAILS"
.sp
It is for example useful when you have a music collection in flac or wav format and want to keep a copy on a mp3 player with the same file and directory structure but with mp3/ogg files instead of the original flac files\&.
.sp
The target format can be specified\&. Currently supported targets are mp3 and ogg\&. mp3 is the default target\&.
.sp
The source directory is walked recursively:
.sp
If the filename exists on the target nothing is done (the file contents itself are not compared), otherwise files are converted:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
flac converted to target format, some id3 Tags are copied too
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
wav converted to target format
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ogg unchanged copied to target
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
mp3 unchanged copied to target
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
m3u, jpg unchanged copied to target
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Volume is adjusted with mp3gain if target format is mp3
.RE
.sp
Missing directories on the target are created\&. The type of file is determined by its extension\&. The source and target directories must exist\&.
.sp
lame, flac, metaflac, mp3gain has to be installed for mp3 target flac, vorbis\-tools has to be installed for ogg target
.SH "AUTHOR"
.sp
Gregor Horvath, gh@gregor\-horvath\&.com
.SH "CONTRIBUTORS"
.sp
Markus Näsman <markus@botten\&.org> : ogg support
.sp
Lionel Duriez : multiprocessing, added flags, windows support
.SH "LICENSE"
.sp
GPL v3
.SH "NOTE"
.sp
This man page, formatted by Didier Spaier for the Slint project from the source README, is free to use by anyone else\&.