.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "Audio::Scan 3pm" .TH Audio::Scan 3pm "2020-11-08" "perl v5.32.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Audio::Scan \- Fast C metadata and tag reader for all common audio file formats .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& use Audio::Scan; \& \& my $data = Audio::Scan\->scan(\*(Aq/path/to/file.mp3\*(Aq); \& \& # Just file info \& my $info = Audio::Scan\->scan_info(\*(Aq/path/to/file.mp3\*(Aq); \& \& # Just tags \& my $tags = Audio::Scan\->scan_tags(\*(Aq/path/to/file.mp3\*(Aq); \& \& # Scan without reading (possibly large) artwork into memory. \& # Instead of binary artwork data, the size of the artwork will be returned instead. \& { \& local $ENV{AUDIO_SCAN_NO_ARTWORK} = 1; \& my $data = Audio::Scan\->scan(\*(Aq/path/to/file.mp3\*(Aq); \& } \& \& # Scan a filehandle \& open my $fh, \*(Aq<\*(Aq, \*(Aqmy.mp3\*(Aq; \& my $data = Audio::Scan\->scan_fh( mp3 => $fh ); \& close $fh; \& \& # Scan and compute an audio MD5 checksum \& my $data = Audio::Scan\->scan( \*(Aq/path/to/file.mp3\*(Aq, { md5_size => 100 * 1024 } ); \& my $md5 = $data\->{info}\->{audio_md5}; .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" Audio::Scan is a C\-based scanner for audio file metadata and tag information. It currently supports \s-1MP3, MP4,\s0 Ogg Vorbis, \s-1FLAC, ASF, WAV, AIFF,\s0 Musepack, Monkey's Audio, and WavPack. .PP See below for specific details about each file format. .SH "METHODS" .IX Header "METHODS" .ie n .SS "scan( $path, [ \e%OPTIONS ] )" .el .SS "scan( \f(CW$path\fP, [ \e%OPTIONS ] )" .IX Subsection "scan( $path, [ %OPTIONS ] )" Scans \f(CW$path\fR for both metadata and tag information. The type of scan performed is determined by the file's extension. Supported extensions are: .PP .Vb 11 \& MP3: mp3, mp2 \& MP4: mp4, m4a, m4b, m4p, m4v, m4r, k3g, skm, 3gp, 3g2, mov \& AAC (ADTS): aac \& Ogg: ogg, oga \& FLAC: flc, flac, fla \& ASF: wma, wmv, asf \& Musepack: mpc, mpp, mp+ \& Monkey\*(Aqs Audio: ape, apl \& WAV: wav \& AIFF: aiff, aif \& WavPack: wv .Ve .PP This method returns a hashref containing two other hashrefs: info and tags. The contents of the info and tag hashes vary depending on file format, see below for details. .PP An optional hashref may be provided with the following values: .PP .Vb 1 \& md5_size => $audio_bytes_to_checksum .Ve .PP An \s-1MD5\s0 will be computed of the first N audio bytes. Any tags in the file are automatically skipped, so this is a useful way of determining if a file's audio content is the same even if tags may have been changed. The hex \s-1MD5\s0 value is returned in the \f(CW$info\fR\->{audio_md5} key. This option will reduce performance, so choose a small enough size that works for you, you should probably avoid using more than 64K for example. .PP For \s-1FLAC\s0 files that already contain an \s-1MD5\s0 checksum, this value will be used instead of calculating a new one. .PP .Vb 1 \& md5_offset => $offset .Ve .PP Begin computing the audio_md5 value starting at \f(CW$offset\fR. If this value is not specified, \&\f(CW$offset\fR defaults to a point in the middle of the file. .ie n .SS "scan_info( $path, [ \e%OPTIONS ] )" .el .SS "scan_info( \f(CW$path\fP, [ \e%OPTIONS ] )" .IX Subsection "scan_info( $path, [ %OPTIONS ] )" If you only need file metadata and don't care about tags, you can use this method. .ie n .SS "scan_tags( $path, [ \e%OPTIONS ] )" .el .SS "scan_tags( \f(CW$path\fP, [ \e%OPTIONS ] )" .IX Subsection "scan_tags( $path, [ %OPTIONS ] )" If you only need the tags and don't care about the metadata, use this method. .ie n .SS "scan_fh( $type => $fh, [ \e%OPTIONS ] )" .el .SS "scan_fh( \f(CW$type\fP => \f(CW$fh\fP, [ \e%OPTIONS ] )" .IX Subsection "scan_fh( $type => $fh, [ %OPTIONS ] )" Scans a filehandle. \f(CW$type\fR is the type of file to scan as, i.e. \*(L"mp3\*(R" or \*(L"ogg\*(R". Note that \s-1FLAC\s0 does not support reading from a filehandle. .ie n .SS "find_frame( $path, $timestamp_in_ms )" .el .SS "find_frame( \f(CW$path\fP, \f(CW$timestamp_in_ms\fP )" .IX Subsection "find_frame( $path, $timestamp_in_ms )" Returns the byte offset to the first audio frame starting from the given timestamp (in milliseconds). .IP "\s-1MP3,\s0 Ogg, \s-1FLAC, ASF, MP4\s0" 4 .IX Item "MP3, Ogg, FLAC, ASF, MP4" The byte offset to the data packet containing this timestamp will be returned. For file formats that don't provide timestamp information such as \s-1MP3,\s0 the best estimate for the location of the timestamp will be returned. This will be more accurate if the file has a Xing header or is \s-1CBR\s0 for example. .IP "\s-1WAV, AIFF,\s0 Musepack, Monkey's Audio, WavPack" 4 .IX Item "WAV, AIFF, Musepack, Monkey's Audio, WavPack" Not yet supported by find_frame. .ie n .SS "find_frame_return_info( $mp4_path, $timestamp_in_ms )" .el .SS "find_frame_return_info( \f(CW$mp4_path\fP, \f(CW$timestamp_in_ms\fP )" .IX Subsection "find_frame_return_info( $mp4_path, $timestamp_in_ms )" The header of an \s-1MP4\s0 file contains various metadata that refers to the structure of the audio data, making seeking more difficult to perform. This method will return the usual \f(CW$info\fR hash with 2 additional keys: .PP .Vb 4 \& seek_offset \- The seek offset in bytes \& seek_header \- A rewritten MP4 header that can be prepended to the audio data \& found at seek_offset to construct a valid bitstream. Specifically, \& the following boxes are rewritten: stts, stsc, stsz, stco .Ve .PP For example, to seek 30 seconds into a file and write out a new \s-1MP4\s0 file seeked to this point: .PP .Vb 1 \& my $info = Audio::Scan\->find_frame_return_info( $file, 30000 ); \& \& open my $f, \*(Aq<\*(Aq, $file; \& sysseek $f, $info\->{seek_offset}, 1; \& \& open my $fh, \*(Aq>\*(Aq, \*(Aqseeked.m4a\*(Aq; \& print $fh $info\->{seek_header}; \& \& while ( sysread( $f, my $buf, 65536 ) ) { \& print $fh $buf; \& } \& \& close $f; \& close $fh; .Ve .ie n .SS "find_frame_fh( $type => $fh, $offset )" .el .SS "find_frame_fh( \f(CW$type\fP => \f(CW$fh\fP, \f(CW$offset\fP )" .IX Subsection "find_frame_fh( $type => $fh, $offset )" Same as \f(CW\*(C`find_frame\*(C'\fR, but with a filehandle. .ie n .SS "find_frame_fh_return_info( $type => $fh, $offset )" .el .SS "find_frame_fh_return_info( \f(CW$type\fP => \f(CW$fh\fP, \f(CW$offset\fP )" .IX Subsection "find_frame_fh_return_info( $type => $fh, $offset )" Same as \f(CW\*(C`find_frame_return_info\*(C'\fR, but with a filehandle. .SS "\fBhas_flac()\fP" .IX Subsection "has_flac()" Deprecated. Always returns 1 now that \s-1FLAC\s0 is always enabled. .ie n .SS "is_supported( $path )" .el .SS "is_supported( \f(CW$path\fP )" .IX Subsection "is_supported( $path )" Returns 1 if the given path can be scanned by Audio::Scan, or 0 if not. .SS "\fBget_types()\fP" .IX Subsection "get_types()" Returns an array of strings of the file types supported by Audio::Scan. .ie n .SS "extensions_for( $type )" .el .SS "extensions_for( \f(CW$type\fP )" .IX Subsection "extensions_for( $type )" Returns an array of strings of the file extensions that are considered to be the file type \fI\f(CI$type\fI\fR. .ie n .SS "type_for( $extension )" .el .SS "type_for( \f(CW$extension\fP )" .IX Subsection "type_for( $extension )" Returns file type for a given extension. Returns \fIundef\fR for unsupported extensions. .SH "SKIPPING ARTWORK" .IX Header "SKIPPING ARTWORK" To save memory while reading tags, you can opt to skip potentially large embedded artwork. To do this, set the environment variable \s-1AUDIO_SCAN_NO_ARTWORK:\s0 .PP .Vb 2 \& local $ENV{AUDIO_SCAN_NO_ARTWORK} = 1; \& my $tags = Audio::Scan\->scan_tags($file); .Ve .PP This will return the length of the embedded artwork instead of the actual image data. In some cases it will also return a byte offset to the image data, which can be used to extract the image using more efficient means. Note that the offset is not always returned so if you want to use this data make sure to check for offset. If offset is not present, the only way to get the image data is to perform a normal tag scan without the environment variable set. .PP One limitation that currently exists is that memory for embedded images is still allocated for \s-1ASF\s0 and Ogg Vorbis files. .PP This information is returned in different ways depending on the format: .PP \&\s-1ID3\s0 (\s-1MP3, AAC, WAV, AIFF\s0): .PP .Vb 2 \& $tags\->{APIC}\->[3]: image length \& $tags\->{APIC}\->[4]: image offset (unless APIC would need unsynchronization) .Ve .PP \&\s-1MP4:\s0 .PP .Vb 2 \& $tags\->{COVR}: image length \& $tags\->{COVR_offset}: image offset (always available) .Ve .PP Ogg Vorbis: .PP .Vb 2 \& $tags\->{ALLPICTURES}\->[0]\->{image_data}: image length \& Image offset is not supported with Vorbis because the data is always base64\-encoded. .Ve .PP \&\s-1FLAC:\s0 .PP .Vb 2 \& $tags\->{ALLPICTURES}\->[0]\->{image_data}: image length \& $tags\->{ALLPICTURES}\->[0]\->{offset}: image offset (always available) .Ve .PP \&\s-1ASF:\s0 .PP .Vb 2 \& $tags\->{\*(AqWM/Picture\*(Aq}\->{image}: image length \& $tags\->{\*(AqWM/Picture\*(Aq}\->{offset}: image offset (always available) .Ve .PP \&\s-1APE,\s0 Musepack, WavPack, \s-1MP3\s0 with APEv2: .PP .Vb 2 \& $tags\->{\*(AqCOVER ART (FRONT)\*(Aq}: image length \& $tags\->{\*(AqCOVER ART (FRONT)_offset\*(Aq}: image offset (always available) .Ve .SH "MP3" .IX Header "MP3" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file may be returned: .PP .Vb 10 \& id3_version (i.e. "ID3v2.4.0") \& id3_was_unsynced (if a v2.2/v2.3 file needed whole\-tag unsynchronization) \& song_length_ms (duration in milliseconds) \& layer (i.e. 3) \& stereo \& samples_per_frame \& padding \& audio_size (size of all audio frames) \& audio_offset (byte offset to first audio frame) \& bitrate (in bps, determined using Xing/LAME/VBRI if possible, or average in the worst case) \& samplerate (in kHz) \& vbr (1 if file is VBR) \& dlna_profile (if file is compliant) \& \& If a Xing header is found: \& xing_frames \& xing_bytes \& xing_quality \& \& If a VBRI header is found: \& vbri_delay \& vbri_frames \& vbri_bytes \& vbri_quality \& \& If a LAME header is found: \& lame_encoder_version \& lame_tag_revision \& lame_vbr_method \& lame_lowpass \& lame_replay_gain_radio \& lame_replay_gain_audiophile \& lame_encoder_delay \& lame_encoder_padding \& lame_noise_shaping \& lame_stereo_mode \& lame_unwise_settings \& lame_source_freq \& lame_surround \& lame_preset .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" Raw tags are returned as found. This means older tags such as ID3v1 and ID3v2.2/v2.3 are converted to ID3v2.4 tag names. Multiple instances of a tag in a file will be returned as arrays. Complex tags such as \s-1APIC\s0 and \s-1COMM\s0 are returned as arrays. All tag fields are converted to upper-case. All text is converted to \s-1UTF\-8.\s0 .PP Sample tag data: .PP .Vb 10 \& tags => { \& ALBUMARTISTSORT => "Solar Fields", \& APIC => [ "image/jpeg", 3, "", ], \& CATALOGNUMBER => "INRE 017", \& COMM => ["eng", "", "Amazon.com Song ID: 202981429"], \& "MUSICBRAINZ ALBUM ARTIST ID" => "a2af1f31\-c9eb\-4fff\-990c\-c4f547a11b75", \& "MUSICBRAINZ ALBUM ID" => "282143c9\-6191\-474d\-a31a\-1117b8c88cc0", \& "MUSICBRAINZ ALBUM RELEASE COUNTRY" => "FR", \& "MUSICBRAINZ ALBUM STATUS" => "official", \& "MUSICBRAINZ ALBUM TYPE" => "album", \& "MUSICBRAINZ ARTIST ID" => "a2af1f31\-c9eb\-4fff\-990c\-c4f547a11b75", \& "REPLAYGAIN_ALBUM_GAIN" => "\-2.96 dB", \& "REPLAYGAIN_ALBUM_PEAK" => "1.045736", \& "REPLAYGAIN_TRACK_GAIN" => "+3.60 dB", \& "REPLAYGAIN_TRACK_PEAK" => "0.892606", \& TALB => "Leaving Home", \& TCOM => "Magnus Birgersson", \& TCON => "Ambient", \& TCOP => "2005 ULTIMAE RECORDS", \& TDRC => "2004\-10", \& TIT2 => "Home", \& TPE1 => "Solar Fields", \& TPE2 => "Solar Fields", \& TPOS => "1/1", \& TPUB => "Ultimae Records", \& TRCK => "1/11", \& TSOP => "Solar Fields", \& UFID => [ \& "http://musicbrainz.org", \& "1084278a\-2254\-4613\-a03c\-9fed7a8937ca", \& ], \& }, .Ve .SH "MP4" .IX Header "MP4" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file may be returned: .PP .Vb 12 \& audio_offset (byte offset to start of mdat) \& audio_size \& compatible_brands \& file_size \& leading_mdat (if file has mdat before moov) \& major_brand \& minor_version \& song_length_ms \& timescale \& dlna_profile (if file is compliant) \& tracks (array of tracks in the file) \& Each track may contain: \& \& audio_type \& avg_bitrate \& bits_per_sample \& channels \& duration \& encoding \& handler_name \& handler_type \& id \& max_bitrate \& samplerate .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" Tags are returned in a hash with all keys converted to upper-case. Keys starting with 0xA9 (copyright symbol) will have this character stripped out. Sample tag data: .PP .Vb 10 \& tags => { \& AART => "Album Artist", \& ALB => "Album", \& ART => "Artist", \& CMT => "Comments", \& COVR => , \& CPIL => 1, \& DAY => 2009, \& DESC => "Video Description", \& DISK => "1/2", \& "ENCODING PARAMS" => "vers\e0\e0\e0\e1acbf\e0\e0\e0\e2brat\e0\e1w\e0cdcv\e0\e1\e6\e5", \& GNRE => "Jazz", \& GRP => "Grouping", \& ITUNNORM => " 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000", \& ITUNSMPB => " 00000000 00000840 000001E4 00000000000001DC 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000", \& LYR => "Lyrics", \& NAM => "Name", \& PGAP => 1, \& SOAA => "Sort Album Artist", \& SOAL => "Sort Album", \& SOAR => "Sort Artist", \& SOCO => "Sort Composer", \& SONM => "Sort Name", \& SOSN => "Sort Show", \& TMPO => 120, \& TOO => "iTunes 8.1.1, QuickTime 7.6", \& TRKN => "1/10", \& TVEN => "Episode ID", \& TVES => 12, \& TVSH => "Show", \& TVSN => 12, \& WRT => "Composer", \& }, .Ve .SH "AAC (ADTS)" .IX Header "AAC (ADTS)" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file is returned: .PP .Vb 9 \& audio_offset \& audio_size \& bitrate (in bps) \& channels \& file_size \& profile (Main, LC, or SSR) \& samplerate (in kHz) \& song_length_ms (duration in milliseconds) \& dlna_profile (if file is compliant) .Ve .SH "OGG VORBIS" .IX Header "OGG VORBIS" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file is returned: .PP .Vb 10 \& version \& channels \& stereo \& samplerate (in kHz) \& bitrate_average (in bps) \& bitrate_upper \& bitrate_nominal \& bitrate_lower \& blocksize_0 \& blocksize_1 \& audio_offset (byte offset to audio) \& audio_size \& song_length_ms (duration in milliseconds) .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" Raw Vorbis comments are returned. All comment keys are capitalized. .SH "FLAC" .IX Header "FLAC" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file is returned: .PP .Vb 10 \& channels \& samplerate (in kHz) \& bitrate (in bps) \& file_size \& audio_offset (byte offset to first audio frame) \& audio_size \& song_length_ms (duration in milliseconds) \& bits_per_sample \& frames \& minimum_blocksize \& maximum_blocksize \& minimum_framesize \& maximum_framesize \& audio_md5 \& total_samples .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" Raw \s-1FLAC\s0 comments are returned. All comment keys are capitalized. Some data returned is special: .PP \&\s-1APPLICATION\s0 .PP .Vb 1 \& Each application block is returned in the APPLICATION tag keyed by application ID. .Ve .PP \&\s-1CUESHEET_BLOCK\s0 .PP .Vb 1 \& The CUESHEET_BLOCK tag is an array containing each line of the cue sheet. .Ve .PP \&\s-1ALLPICTURES\s0 .PP .Vb 1 \& Embedded pictures are returned in an ALLPICTURES array. Each picture has the following metadata: \& \& mime_type \& description \& width \& height \& depth \& color_index \& image_data \& picture_type .Ve .SH "ASF (Windows Media Audio/Video)" .IX Header "ASF (Windows Media Audio/Video)" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file may be returned. Reading the \s-1ASF\s0 spec is encouraged if you want to find out more about any of these values. .PP .Vb 10 \& audio_offset (byte offset to first data packet) \& audio_size \& broadcast (boolean, whether the file is a live broadcast or not) \& codec_list (array of information about codecs used in the file) \& creation_date (UNIX timestamp when file was created) \& data_packets \& drm_key \& drm_license_url \& drm_protection_type \& drm_data \& file_id (unique file ID) \& file_size \& index_blocks \& index_entry_interval (in milliseconds) \& index_offsets (byte offsets for each second of audio, per stream. Useful for seeking) \& index_specifiers (indicates which stream a given index_offset points to) \& language_list (array of languages referenced by the file\*(Aqs metadata) \& lossless (boolean) \& max_bitrate \& max_packet_size \& min_packet_size \& mutex_list (mutually exclusive stream information) \& play_duration_ms \& preroll \& script_commands \& script_types \& seekable (boolean, whether the file is seekable or not) \& send_duration_ms \& song_length_ms (the actual length of the audio, in milliseconds) \& dlna_profile (if file is compliant) .Ve .PP \&\s-1STREAMS\s0 .PP The streams array contains metadata related to an individul stream within the file. The following metadata may be returned: .PP .Vb 10 \& DeviceConformanceTemplate \& IsVBR \& alt_bitrate \& alt_buffer_fullness \& alt_buffer_size \& avg_bitrate (most accurate bitrate for this stream) \& avg_bytes_per_sec (audio only) \& bitrate \& bits_per_sample (audio only) \& block_alignment (audio only) \& bpp (video only) \& buffer_fullness \& buffer_size \& channels (audio only) \& codec_id (audio only) \& compression_id (video only) \& encode_options \& encrypted (boolean) \& error_correction_type \& flag_seekable (boolean) \& height (video only) \& index_type \& language_index (offset into language_list array) \& max_object_size \& samplerate (in kHz) (audio only) \& samples_per_block \& stream_number \& stream_type \& super_block_align \& time_offset \& width (video only) .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" Raw tags are returned. Tags that occur more than once are returned as arrays. In contrast to the other formats, tag keys are \s-1NOT\s0 capitalized. There is one special key: .PP WM/Picture .PP Pictures are returned as a hash with the following keys: .PP .Vb 4 \& image_type (numeric type, same as ID3v2 APIC) \& mime_type \& description \& image .Ve .SH "WAV" .IX Header "WAV" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file may be returned. .PP .Vb 12 \& audio_offset \& audio_size \& bitrate (in bps) \& bits_per_sample \& block_align \& channels \& dlna_profile (if file is compliant) \& file_size \& format (WAV format code, 1 == PCM) \& id3_version (if an ID3v2 tag is found) \& samplerate (in kHz) \& song_length_ms .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" \&\s-1WAV\s0 files can contain several different types of tags. \*(L"Native\*(R" \s-1WAV\s0 tags found in a \s-1LIST\s0 block may include these and others: .PP .Vb 10 \& IARL \- Archival Location \& IART \- Artist \& ICMS \- Commissioned \& ICMT \- Comment \& ICOP \- Copyright \& ICRD \- Creation Date \& ICRP \- Cropped \& IENG \- Engineer \& IGNR \- Genre \& IKEY \- Keywords \& IMED \- Medium \& INAM \- Name (Title) \& IPRD \- Product (Album) \& ISBJ \- Subject \& ISFT \- Software \& ISRC \- Source \& ISRF \- Source Form \& TORG \- Label \& LOCA \- Location \& TVER \- Version \& TURL \- URL \& TLEN \- Length \& ITCH \- Technician \& TRCK \- Track \& ITRK \- Track .Ve .PP ID3v2 tags can also be embedded within \s-1WAV\s0 files. These are returned exactly as for \s-1MP3\s0 files. .SH "AIFF" .IX Header "AIFF" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file may be returned. .PP .Vb 10 \& audio_offset \& audio_size \& bitrate (in bps) \& bits_per_sample \& block_align \& channels \& compression_name (if AIFC) \& compression_type (if AIFC) \& dlna_profile (if file is compliant) \& file_size \& id3_version (if an ID3v2 tag is found) \& samplerate (in kHz) \& song_length_ms .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" ID3v2 tags can be embedded within \s-1AIFF\s0 files. These are returned exactly as for \s-1MP3\s0 files. .SH "MONKEY'S AUDIO (APE)" .IX Header "MONKEY'S AUDIO (APE)" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file may be returned. .PP .Vb 9 \& audio_offset \& audio_size \& bitrate (in bps) \& channels \& compression \& file_size \& samplerate (in kHz) \& song_length_ms \& version .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" APEv2 tags are returned as a hash of key/value pairs. .SH "MUSEPACK" .IX Header "MUSEPACK" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file may be returned. .PP .Vb 9 \& audio_offset \& audio_size \& bitrate (in bps) \& channels \& encoder \& file_size \& profile \& samplerate (in kHz) \& song_length_ms .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" Musepack uses APEv2 tags. They are returned as a hash of key/value pairs. .SH "WAVPACK" .IX Header "WAVPACK" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file may be returned. .PP .Vb 12 \& audio_offset \& audio_size \& bitrate (in bps) \& bits_per_sample \& channels \& encoder_version \& file_size \& hybrid (1 if file is lossy) (v4 only) \& lossless (1 if file is lossless) (v4 only) \& samplerate \& song_length_ms \& total_samples .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" WavPack uses APEv2 tags. They are returned as a hash of key/value pairs. .SH "DSF" .IX Header "DSF" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file may be returned. .PP .Vb 7 \& audio_offset \& audio_size \& bits_per_sample \& channels \& song_length_ms \& samplerate \& block_size_per_channel .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" ID3v2 tags can be embedded within \s-1DSF\s0 files. These are returned exactly as for \s-1MP3\s0 files. .SH "DSDIFF (DFF)" .IX Header "DSDIFF (DFF)" .SS "\s-1INFO\s0" .IX Subsection "INFO" The following metadata about a file may be returned. .PP .Vb 8 \& audio_offset \& audio_size \& bits_per_sample \& channels \& song_length_ms \& samplerate \& tag_diti_title \& tag_diar_artist .Ve .SS "\s-1TAGS\s0" .IX Subsection "TAGS" No separate tags are supported by the \s-1DSDIFF\s0 format. .SH "" .IX Header "" .SH "THANKS" .IX Header "THANKS" Logitech & Slim Devices, for letting us release so much of our code to the world. Long live Squeezebox! .PP Kimmo Taskinen, Adrian Smith, Clive Messer, and Jurgen Kramer for \&\s-1DSF/DSDIFF\s0 support and various other fixes. .PP Some code from the Rockbox project was very helpful in implementing \s-1ASF\s0 and \&\s-1MP4\s0 seeking. .PP Some of the file format parsing code was derived from the mt-daapd project, and adapted by Netgear. It has been heavily rewritten to fix bugs and add more features. .PP The source to the original Netgear C scanner for SqueezeCenter is located at .PP The audio \s-1MD5\s0 feature uses an \s-1MD5\s0 implementation by L. Peter Deutsch, . .SH "SEE ALSO" .IX Header "SEE ALSO" \&\s-1ASF\s0 Spec .PP \&\s-1MP4\s0 Info: .SH "AUTHORS" .IX Header "AUTHORS" Andy Grundman, .PP Dan Sully, .SH "COPYRIGHT AND LICENSE" .IX Header "COPYRIGHT AND LICENSE" Copyright (C) 2010\-2011 Logitech, Inc. .PP This program is free software; you can redistribute it and/or modify it under the terms of the \s-1GNU\s0 General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.