.\""Copyright (c) 2022 Apple Inc. All Rights Reserved.
.Dd $Mdocdate$
.Dt SHAZAM-CUSTOM-CATALOG-UPDATE 1
.Os

.Sh NAME
.Nm shazam custom-catalog update
.Nd Update an existing custom catalog with a signature and its associated media items

.Sh SYNOPSIS
.Nm
.Op Fl \-input Ar input
.Op Fl \-signature-asset Ar signature-asset
.Op Fl \-media-items Ar media-items
.Op Fl \-output Ar output


.Sh DESCRIPTION
.Pp
Use this command to update an existing custom catalog file with a shazam signature and associated media items. A shazam signature can be generated from any of the following inputs:
.Bl -enum
.It
A .shazamsignature file
.It
An audio file
.It
A video file
.El

Media items can be grouped in a .csv file and passed to this command to be associated with the shazam signature as metadata in the updated custom catalog.
.Sh OPTIONS
.Bl -tag -width indent

.It Fl i,--input Ar input
Path to the existing custom catalog file to update.

.It Fl m,--media-items Ar media-items
Path to a .csv file containing metadata to be associated with a shazam signature.

.It Fl o,--output Ar output
Path to save the updated custom catalog file. If this is a directory a new custom catalog file is created in that directory with the same name as the file passed in
.Ar signature-asset \.
If this argument isn't passed in, the existing catalog file is updated in place and the custom catalog file at
.Ar input
is overwritten with the updated file.

.It Fl s,--signature-asset Ar signature-asset
Path to an audio, video or shazam signature file.

.Sh SEE ALSO
.Sy shazam-signature(1), shazam-custom-catalog-create(1), shazam-custom-catalog-remove(1)

.Sh NOTES
.Bl -enum
.It
ShazamKit Documentation
.Bd -literal -compact
https://developer.apple.com/shazamkit
.El