second commit

This commit is contained in:
2024-12-27 22:31:23 +09:00
parent 2353324570
commit 10a0f110ca
8819 changed files with 1307198 additions and 28 deletions

66
env/share/man/man1/mid3cp.1 vendored Normal file
View File

@ -0,0 +1,66 @@
.\" Man page generated from reStructuredText.
.
.TH MID3CP 1 "" "" ""
.SH NAME
mid3cp \- copy ID3 tags
.
.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
\fBmid3cp\fP [\fIoptions\fP] \fIsource\fP \fIdest\fP
.SH DESCRIPTION
.sp
\fBmid3cp\fP copies the ID3 tags from a source file to a destination file.
.sp
It is designed to provide similar functionality to id3lib\(aqs id3cp tool, and can
optionally write ID3v1 tags. It can also exclude specific tags from being
copied.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-verbose\fP,\fB \-v
Be verbose: state all operations performed, and list tags in source file.
.TP
.B \-\-write\-v1
Write ID3v1 tags to the destination file, derived from the ID3v2 tags.
.TP
.B \-\-exclude\-tag\fP,\fB \-x
Exclude a specific tag from being copied. Can be specified multiple times.
.TP
.B \-\-merge
Copy over frames instead of replacing the whole ID3 tag. The tag version
of \fIdest\fP will be used. In case \fIdest\fP has no ID3 tag this option has no
effect.
.UNINDENT
.SH AUTHOR
.sp
Marcus Sundman.
.sp
Based on id3cp (part of id3lib) by Dirk Mahoney and Scott Thomas Haug.
.\" Generated by docutils manpage writer.
.

68
env/share/man/man1/mid3iconv.1 vendored Normal file
View File

@ -0,0 +1,68 @@
.\" Man page generated from reStructuredText.
.
.TH MID3ICONV 1 "" "" ""
.SH NAME
mid3iconv \- convert ID3 tag encodings
.
.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
\fBmid3iconv\fP [\fIoptions\fP] \fIfilename\fP ...
.SH DESCRIPTION
.sp
\fBmid3iconv\fP converts ID3 tags from legacy encodings to Unicode and stores
them using the ID3v2 format.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-debug\fP,\fB \-d
Print updated tags
.TP
.B \-\-dry\-run\fP,\fB \-p
Do not actually modify files
.TP
.B \-\-encoding\fP,\fB \-e
Convert from this encoding. By default, your locale\(aqs default encoding is
used.
.TP
.B \-\-force\-v1
Use an ID3v1 tag even if an ID3v2 tag is present
.TP
.B \-\-quiet\fP,\fB \-q
Only output errors
.TP
.B \-\-remove\-v1
Remove any ID3v1 tag after processing the files
.UNINDENT
.SH AUTHOR
.sp
Emfox Zhou.
.sp
Based on id3iconv (\fI\%http://www.cs.berkeley.edu/~zf/id3iconv/\fP) by Feng Zhou.
.\" Generated by docutils manpage writer.
.

151
env/share/man/man1/mid3v2.1 vendored Normal file
View File

@ -0,0 +1,151 @@
.\" Man page generated from reStructuredText.
.
.TH MID3V2 1 "" "" ""
.SH NAME
mid3v2 \- audio tag editor similar to 'id3v2'
.
.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
\fBmid3v2\fP [\fIoptions\fP] \fIfilename\fP ...
.SH DESCRIPTION
.sp
\fBmid3v2\fP is a Mutagen\-based replacement for id3lib\(aqs id3v2. It supports
ID3v2.4 and more frames; it also does not have the numerous bugs that plague
id3v2.
.sp
This program exists mostly for compatibility with programs that want to tag
files using id3v2. For a more usable interface, we recommend Ex Falso.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-q\fP,\fB \-\-quiet
Be quiet: do not mention file operations that perform the user\(aqs
request. Warnings will still be printed.
.TP
.B \-v\fP,\fB \-\-verbose
Be verbose: state all operations performed. This is the opposite of
\-\-quiet. This is the default.
.TP
.B \-e\fP,\fB \-\-escape
Enable interpretation of backslash escapes for tag values.
Makes it possible to escape the colon\-separator in TXXX, WXXX, COMM
values like \(aq\e:\(aq and insert escape sequences like \(aq\en\(aq, \(aq\et\(aq etc.
.TP
.B \-f\fP,\fB \-\-list\-frames
Display all supported ID3v2.3/2.4 frames and their meanings.
.TP
.B \-L\fP,\fB \-\-list\-genres
List all ID3v1 numeric genres. These can be used to set TCON frames,
but it is not recommended.
.TP
.B \-l\fP,\fB \-\-list
List all tags in the files. The output format is \fInot\fP the same as
id3v2\(aqs; instead, it is easily parsable and readable. Some tags may not
have human\-readable representations.
.TP
.B \-\-list\-raw
List all tags in the files, in raw format. Although this format is
nominally human\-readable, it may be very long if the tag contains
embedded binary data.
.TP
.B \-d\fP,\fB \-\-delete\-v2
Delete ID3v2 tags.
.TP
.B \-s\fP,\fB \-\-delete\-v1
Delete ID3v1 tags.
.TP
.B \-D\fP,\fB \-\-delete\-all
Delete all ID3 tags.
.TP
.BI \-\-delete\-frames\fB= FRAMES
Delete specific ID3v2 frames (or groups of frames) from the files.
\fBFRAMES\fP is a "," separated list of frame names e.g. \fB"TPE1,TALB"\fP
.TP
.B \-C\fP,\fB \-\-convert
Convert ID3v1 tags to ID3v2 tags. This will also happen automatically
during any editing.
.TP
.BI \-a\fP,\fB \-\-artist\fB= ARTIST
Set the artist information (TPE1).
.TP
.BI \-A\fP,\fB \-\-album\fB= ALBUM
Set the album information (TALB).
.TP
.BI \-t\fP,\fB \-\-song\fB= TITLE
Set the title information (TIT2).
.TP
.BI \-c\fP,\fB \-\-comment\fB= <DESCRIPTION:COMMENT:LANGUAGE>
Set a comment (COMM). The language and description may be omitted, in
which case the language defaults to English, and the description to an
empty string.
.TP
.BI \-p\fP,\fB \-\-picture\fB= <FILENAME:DESCRIPTION:IMAGE\-TYPE:MIME\-TYPE>
Set the attached picture (APIC). Everything except the filename can be
omitted in which case default values will be used.
.TP
.BI \-g\fP,\fB \-\-genre\fB= GENRE
Set the genre information (TCON).
.TP
.BI \-y\fP,\fB \-\-year\fB= <YYYY>\fP,\fB \ \-\-date\fB= <YYYY\-[MM\-DD]>
Set the year/date information (TDRC).
.TP
.BI \-T\fP,\fB \-\-track\fB= <NUM/NUM>
Set the track number (TRCK).
.UNINDENT
.sp
Any text or URL frame (those beginning with T or W) can be modified or
added by prefixing the name of the frame with "\-\-". For example, \fB\-\-TIT3
"Monkey!"\fP will set the TIT3 (subtitle) frame to \fBMonkey!\fP\&.
.sp
The TXXX frame has the format <DESCRIPTION:TEXT>; many TXXX frames may be
set in the file as long as they have different keys. To set this key, just
separate the text with a colon, e.g. \fB\-\-TXXX "ALBUMARTISTSORT:Examples,
The"\fP\&. The description can be omitted in which case it defaults to an empty
string.
.sp
The WXXX frame has the same format as TXXX but since URLs usually contain a
":" you have provide a description or enable escaping (\-e):
\fB\-\-WXXX "desc:http://foo.bar"\fP or \fB\-e \-\-WXXX "http\e\e://foo.bar"\fP
.sp
The USLT frame has the format <DESCRIPTION:TEXT:LANGUAGE>. The language and
description may be omitted, in which case the language defaults to English,
and the description to an empty string.
.sp
The special POPM frame can be set in a similar way: \fB\-\-POPM
"bob@example.com:128:2"\fP to set Bob\(aqs rating to 128/255 with 2 plays.
.SH BUGS
.sp
No sanity checking is done on the editing operations you perform, so mid3v2
will happily accept \-\-TSIZ when editing an ID3v2.4 frame. However, it will
also automatically throw it out during the next edit operation.
.SH AUTHOR
.sp
Joe Wreschnig is the author of mid3v2, but he doesn\(aqt like to admit it.
.\" Generated by docutils manpage writer.
.

64
env/share/man/man1/moggsplit.1 vendored Normal file
View File

@ -0,0 +1,64 @@
.\" Man page generated from reStructuredText.
.
.TH MOGGSPLIT 1 "" "" ""
.SH NAME
moggsplit \- split Ogg logical streams
.
.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
\fBmoggsplit\fP \fIfilename\fP ...
.SH DESCRIPTION
.sp
\fBmoggsplit\fP splits a multiplexed Ogg stream into separate files. For
example, it can separate an OGM into separate Ogg DivX and Ogg Vorbis
streams, or a chained Ogg Vorbis file into two separate files.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-extension
Use the supplied extension when generating new files; the default is
\fBogg\fP\&.
.TP
.B \-\-pattern
Use the supplied pattern when generating new files. This is a Python
keyword format string with three variables, \fIbase\fP for the original
file\(aqs base name, \fIstream\fP for the stream\(aqs serial number, and ext for
the extension give by \fB\-\-extension\fP\&.
.sp
The default is \fB%(base)s\-%(stream)d.%(ext)s\fP\&.
.TP
.B \-\-m3u
Generate an m3u playlist along with the newly generated files. Useful
for large chained Oggs.
.UNINDENT
.SH AUTHOR
.sp
Joe Wreschnig
.\" Generated by docutils manpage writer.
.

47
env/share/man/man1/mutagen-inspect.1 vendored Normal file
View File

@ -0,0 +1,47 @@
.\" Man page generated from reStructuredText.
.
.TH MUTAGEN-INSPECT 1 "" "" ""
.SH NAME
mutagen-inspect \- view Mutagen-supported audio tags
.
.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
\fBmutagen\-inspect\fP \fIfilename\fP ...
.SH DESCRIPTION
.sp
\fBmutagen\-inspect\fP loads and prints information about an audio file and
its tags.
.sp
It is primarily intended as a debugging tool for Mutagen, but can be useful
for extracting tags from the command line.
.SH AUTHOR
.sp
Joe Wreschnig
.\" Generated by docutils manpage writer.
.

46
env/share/man/man1/mutagen-pony.1 vendored Normal file
View File

@ -0,0 +1,46 @@
.\" Man page generated from reStructuredText.
.
.TH MUTAGEN-PONY 1 "" "" ""
.SH NAME
mutagen-pony \- scan a collection of MP3 files
.
.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
\fBmutagen\-pony\fP \fIdirectory\fP ...
.SH DESCRIPTION
.sp
\fBmutagen\-pony\fP scans any directories given and reports on the kinds of
tags in the MP3s it finds in them. Ride the pony.
.sp
It is primarily intended as a debugging tool for Mutagen.
.SH AUTHORS
.sp
Michael Urman and Joe Wreschnig
.\" Generated by docutils manpage writer.
.