.\" Man page generated from reStructuredText.
.
.TH "ISRCSUBMIT" "1" "Feb 25, 2019" "2.1" "isrcsubmit"
.SH NAME
isrcsubmit \- isrcsubmit Documentation
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBisrcsubmit\fP [\fIoptions\fP] [\fIuser\fP] [\fIdevice\fP]
.SH DESCRIPTION
.sp
\fBisrcsubmit\fP extracts International Standard Recording Codes (ISRC)
from audio CDs and allows one to submit the data to MusicBrainz. ISRCs are used
to uniquely identifiy sound and music video recordings.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-version
Show program\(aqs version number and exit.
.TP
.B \-h
Short usage help.
.TP
.B \-\-help
Complete help for the program.
.TP
.B \-\-debug
Show debug messages.
.TP
.BI \-u \ <username>\fP,\fB \ \-\-user\fB= <username>
MusicBrainz username, if not given as argument.
.TP
.BI \-d \ <device>\fP,\fB \ \-\-device\fB= <device>
CD device with a loaded audio CD, if not given as argument. The default is
/dev/cdrom.
.TP
.BI \-\-release\-id\fB= <release_id>
Optional MusicBrainz ID of the release. This will be gathered if not given.
.TP
.BI \-b \ <program>\fP,\fB \ \-\-backend\fB= <program>
Force using a specific backend to extract ISRCs from the disc. Possible
backends are: mediatools, media_info, cdrdao, libdiscid, discisrc. They are
tried in this order otherwise. See also \fBBACKENDS\fP\&.
.TP
.BI \-\-browser\fB= <browser>
Program to open URLs. This will be automatically deteced for most setups,
if not chosen manually.
.TP
.B \-\-force\-submit
Always open TOC/disc ID submission page in browser.
.TP
.BI \-\-server\fB= <server>
Server to send ISRCs to. If not given, musicbrainz.org is used.
.TP
.B \-\-keyring
Use keyring if it is available.
.TP
.B \-\-no\-keyring
Do not use keyring.
.UNINDENT
.SH BACKENDS
.sp
\fBisrcsubmit\fP is able to use various backends to extract the ISRC.
The \fBlibdiscid\fP library is a requirement for isrcsubmit
and can also be used as a backend on most systems.
.sp
ISRCs are nearly always stored in the subchannel information
and all tools read them from there.
However, some drives tend to extract the same ISRC for adjacent tracks.
Restarting the script might help and using a different drive might help.
CD writers are reported to give better results than many CD reader drives.
.INDENT 0.0
.TP
.B mediatools, media_info
These tools use an experimental algorithm to gather ISRCs from the disc.
This should give less duplicates on the same drive than with other tools.
However, there might be other problems. (only available for Windows)
.TP
.B cdrdao
This tool can read ISRCs from CD\-Text if no ISRCs are in the subchannel
information.
This is rarely the case. Most ISRCs are stored in the subchannel.
(usually available on Linux, but there are also Windows builds (plank))
.TP
.B libdiscid
Starting with \fBlibdiscid\fP 0.3.0 this can be used not only for
the disc ID, but also to extract ISRCs.
(Windows, Mac; Linux support with 0.3.1)
.TP
.B discisrc
The \fBdiscisrc\fP binary is created from source builds of \fBlibdiscid\fP\&.
There is an experimental branch \fIisrc_raw\fP that might give
better results regarding duplicate ISRCs on Linux.
You can use this binary separately without installing
an experimental libdiscid library on the system.
.UNINDENT
.SH SEE ALSO
.sp
\fBisrcsubmit\-config(5)\fP
.SH AUTHOR
.sp
This manual was written by Sebastian Ramacher and Johannes Dewender.
\fBisrcsubmit\fP was written by Johannes Dewender.
.SH COPYRIGHT
2009-2019, Johannes Dewender
.\" Generated by docutils manpage writer.
.