2.8.1 scribbu popm
Options ¶
- -h,--help display help & exit with status zero
- -n,--dry-run don’t modify the files named in the arguments; just
print what would have been done
- -f,--create-frame create playcount and/or popularimeter in
any tags that are missing. This can be modified by the
--popularimeter-only and --playcount-only flags,
respectively. Popularimeter frames will only be created if the
--owner flag is given, as well.
- -c|--create-v2 create an ID3v2 tag with a POPM and/or PCNT
frames for any file that has an ID3v1 tag but does not have an ID3v2
tag; may not be combined with --always-create-v2
- -a|--always-create-v2 always create an ID3v2 tag with a POPM
and/or PCNT frame for any file that does not possess one (whether or
not there’s an ID3v1 tag present); may not be combined with
--create-v2.
- -b,--create-backups by default, the new tagset will be written
in-place (emplacing, if possible); this option will cause a backup file
to be made first.
- -C COUNT,--count=COUNT set all counter fields to
COUNT
instead of incrementing
- -i INCR,--increment=INCR increment all counter fields by
INCR
, instead of by one.
- -o OWNER,--owner=OWNER Specify the owner field for popularimeter
frames. If incrementing count fields, only popularimeter frames with an
owner of
OWNER
will be updated. When creating popularimeter frames,
the owner field will be set to OWNER
.
- -p,--playcount-only if present, this switch will limit operations
to playcount frames only
- -m,--popularimeter-only if present, this switch will limit operaitons
to popularimeter frames only
- -r RATING,--rating=RATING specify the rating for use in
popularimeter tags.
RATING
may be given either as an integer
between 0 & 255 (inclusive) or as one-to-five “stars”, given as
[a-zA-Z@#%*+]{1,5}
e.g. three stars could be expressed as
“xxx” or “###” or “***”.
- -t INDEX,--tag=INDEX specify a zero-based index describing
which tag to alter, in case of multiple ID3v2 tags in a single
file. This option may be given more than once to indicate multiple
tags. If not given, all tags will be modified.
- -u,--adjust-unsync adjust each tag’s use of the
unysnchronisation scheme on write (by default, it’s never used)