dano.1

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH DANO "1" "May 2023" "dano 0.7.1" "User Commands"
.SH NAME
dano \- manual page for dano 0.7.1
.SH DESCRIPTION
dano 0.7.1
dano is a wrapper for ffmpeg that checksums the internal file streams of certain media files, and
stores them in a format which can be used to verify such checksums later.  This is handy, because,
should you choose to change metadata tags, or change file names, the media checksums should remain
the same.
.SS "USAGE:"
.IP
dano [OPTIONS] [\-\-] [INPUT_FILES]...
.SS "ARGS:"
.TP
<INPUT_FILES>...
input files to be hashed or verified.  INPUT_FILES can also be read from
stdin for NULL or NEWLINE delimited inputs.
.SS "OPTIONS:"
.HP
\fB\-o\fR, \fB\-\-output\-file=\fR<OUTPUT_FILE>...
.IP
output file which will contain the recorded file information. If not specified,
\&'dano_hashes.txt' in the current working directory will be used.
.HP
\fB\-k\fR, \fB\-\-hash\-file=\fR<HASH_FILE>...
.TP
file from which to read recorded file information.
If not specified, the output file
.IP
will be used (or if not specified 'dano_hashes.txt' in the current working directory).
.HP
\fB\-w\fR, \fB\-\-write\fR
.IP
write the new input files' hash information (and ignore files that already have file
hashes).
.HP
\fB\-t\fR, \fB\-\-test\fR
.TP
verify the recorded file information.
Prints the pass/fail status, exits with a
.IP
non\-zero code if failed, and, potentially, performs write operations, like \fB\-\-write\-new\fR
or \fB\-\-overwrite\fR.
.HP
\fB\-p\fR, \fB\-\-print\fR
.IP
pretty print all recorded file information (in hash file and xattrs).
.HP
\fB\-\-dump\fR
.IP
dump the recorded file information (in hash file and xattrs) to the output file (don't
test/compare).
.HP
\fB\-\-duplicates\fR
.IP
show any hash value duplicates discovered when reading back recorded file information
(in hash file and xattrs).
.HP
\fB\-\-import\-flac\fR
.IP
import flac checksums and write as dano recorded file information.
.HP
\fB\-j\fR, \fB\-\-threads=\fR<NUM_THREADS>...
.TP
requested number of threads to use for file processing.
Default is the number of
.IP
logical cores.
.HP
\fB\-s\fR, \fB\-\-silent\fR
.IP
quiet many informational messages (like "OK").
.HP
\fB\-\-write\-new\fR
.IP
if new files are present in TEST mode, append such file info.
.HP
\fB\-\-overwrite\fR
.IP
if one file's hash matches another's, but they have different file name's, overwrite the
old file's info with the most current.
.HP
\fB\-\-disable\-filter\fR
.TP
by default, file extensions not recognized by ffmpeg are filtered.
Here, you may
.IP
disable such filtering.
.HP
\fB\-\-canonical\-paths\fR
.IP
use canonical paths (instead of potentially relative paths).
.HP
\fB\-x\fR, \fB\-\-xattr\fR
.IP
try to write (dano will always try to read) hash to/from file's extended attributes.
Can also be enabled by setting environment variable DANO_XATTR_WRITES to any value.
When XATTR is enabled, if a write is requested, dano will always overwrite extended
attributes previously written.
.HP
\fB\-\-hash\-algo=\fR<HASH_ALGO>...
.TP
specify the algorithm to use for hashing.
Default is 'murmur3'. [possible values:
.IP
murmur3, md5, crc32, adler32, sha1, sha160, sha256, sha384, sha512]
.HP
\fB\-\-decode\fR
.TP
decode stream before hashing.
Much slower, but potentially useful for lossless formats.
.HP
\fB\-\-rewrite\fR
.TP
rewrite all recorded hashes to the latest and greatest format version.
dano will ignore
.IP
input files without recorded hashes.
.HP
\fB\-\-only=\fR<ONLY>
.IP
hash selected stream only [possible values: audio, video]
.HP
\fB\-\-dry\-run\fR
.IP
print the information to stdout that would be written to disk.
.HP
\fB\-h\fR, \fB\-\-help\fR
.IP
Print help information
.HP
\fB\-V\fR, \fB\-\-version\fR
.IP
Print version information
.SH "SEE ALSO"
The full documentation for
.B dano
is maintained as a Texinfo manual.  If the
.B info
and
.B dano
programs are properly installed at your site, the command
.IP
.B info dano
.PP
should give you access to the complete manual.