TAGGREPPER(1)

💖 TAGGREPPER 💖

okay bestie, welcome to taggrepper — it's a section 1 (User Commands) manual page, so it's a real lil program you run in your shell. buckle up 🎀

✨ NAME ✨

taggrepper — search and match tags of media file for regular expressions 🎵🔍

🌸 SYNOPSIS 🌸

taggrepper [--tag-label regexp]... [--display-taglabel]...
[FILE/DIRECTORY]...

💅 DESCRIPTION 💅

So what it does is: perform a regular expression search on the tags of specified media files. that's the whole vibe. it goes through your files' tags and checks them against your regexes 🫶

Mandatory arguments to long options are mandatory for short options too. (yes literally, that's the rule, no cap)

All regular expressions are Perl Compatible Regular expressions supported by the PCRE libraries. and here's the part that gets people: all matches are ANDed, meaning that for a successful match, matches against all tags must occur. so every tag you ask about has to hit, or the file doesn't make the cut. it's giving strict. 😤

Support exists for MP3 files, and, if compiled in, for Ogg Vorbis and FLAC files as well. slay.

now the options, one by one, all of them, no skipping 🙈

• -t, --title=REGEXP — Match the title tag against REGEXP
• -a, --artist=REGEXP — Match the artist tag against REGEXP
• -l, --album=REGEXP — Match the album, tag against REGEXP
• -y, --year=REGEXP — Match the year tag against REGEXP
• -g, --genre=REGEXP — Match the genre tag against REGEXP
• -c, --comment=REGEXP — Match the comment tag against REGEXP
• --track=REGEXP — Match the track tag against REGEXP
• -c, --composer=REGEXP — Match the composer tag against REGEXP
• -o, --orig-artist=REGEXP — Match the original artist tag against REGEXP
• -c, --copyright=REGEXP — Match the copyright tag against REGEXP
• -u, --url=REGEXP — Match the URL tag against REGEXP
• -e, --encoded-by=REGEXP — Match the encoded-by tag against REGEXP
• --any-tag=REGEXP — Match the encoded-by tag against REGEXP. Using this option makes every one of the above options to be ignored 👀 (yes, the manpage says "encoded-by" here, we are reporting it exactly as it is, don't come for me)
• --display-title — display title tag of matching files
• --display-artist — display artist tag of matching files
• --display-album — display album tag of matching files
• --display-year — display year tag of matching files
• --display-genre — display genre tag of matching files
• --display-comment — display comment tag of matching files
• --display-track — display track tag of matching files
• --display-composer — display composer tag of matching files
• --display-orig-artist — display orig-artist tag of matching files
• --display-copyright — display copyright tag of matching files
• --display-url — display url tag of matching files
• --display-encoded-by — display encoded-by tag of matching files
• -0, --print0, — Use null character as delimiter. This option can be used with -0 option of xargs. (yes there's a comma after --print0, iconic, leaving it)
• -r, --recursive — Search directories recursively 🌈
• -v, --version — Display version and exit
• -h, --help — Display this help message

All regular expressions are PCRE regular expressions. Refer to the PCRE documentation for details. Report comments and bugs to a.kumar@alumni.iitm.ac.in 📧

🎀 COPYING 🎀

Copyright © Kumar Appaiah

License: BSD License (see COPYING file in the distribution tarball for details)

This program is free software; you can distribute it under the terms of the BSD License. See the file COPYING in the tarball, or /usr/share/common-licenses/BSD on Debian-based systems. 🫶

🦋 SEE ALSO 🦋

• pcre(3)

and that's the whole page bestie!! 💖✨ this was taggrepper version 0.01, dated July 2009 — go forth and grep those tags, you absolute main character 👑💅