{"id":15115290,"url":"https://github.com/squell/id3","last_synced_at":"2025-05-12T21:09:31.582Z","repository":{"id":25590904,"uuid":"29025266","full_name":"squell/id3","owner":"squell","description":"ID3 mass tagger","archived":false,"fork":false,"pushed_at":"2024-08-27T10:27:29.000Z","size":799,"stargazers_count":120,"open_issues_count":12,"forks_count":7,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-05-12T21:09:22.660Z","etag":null,"topics":["c-plus-plus","id3","id3v1","id3v2","mp3","tagging"],"latest_commit_sha":null,"homepage":"https://squell.github.io/id3","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/squell.png","metadata":{"files":{"readme":"README","changelog":"CHANGES","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-01-09T16:42:41.000Z","updated_at":"2025-03-16T20:21:28.000Z","dependencies_parsed_at":"2024-01-12T13:48:15.736Z","dependency_job_id":"631ed458-e4c1-48b3-b725-43269fc5ef58","html_url":"https://github.com/squell/id3","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squell%2Fid3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squell%2Fid3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squell%2Fid3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squell%2Fid3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/squell","download_url":"https://codeload.github.com/squell/id3/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253823442,"owners_count":21969847,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c-plus-plus","id3","id3v1","id3v2","mp3","tagging"],"created_at":"2024-09-26T01:43:45.341Z","updated_at":"2025-05-12T21:09:31.555Z","avatar_url":"https://github.com/squell.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"\n                     \n _ _  __ _ _ __  ___ \n| ' \\/ _` | '  \\/ -_)\n|_||_\\__,_|_|_|_\\___|\n                     \n       id3 - a command line mass tagger\n\n                          _    \n ____  _ _ _  ___ _ __ __(_)___\n(_-\u003c || | ' \\/ _ \\ '_ (_-\u003c (_-\u003c\n/__/\\_, |_||_\\___/ .__/__/_/__/\n    |__/         |_|           \n       id3 [-v] [-m] [-123] [-d] [-t title] [-a artist] [-l album]\n\t [-n tracknr] [-y year] [-g genre] [-c comment]\n\t [-f template] [-q format] [-D file] [-R] [-M]\n\t [-E] [-s size] [-u] [-rFRAME] [-wFRAME data] \"filespec\"\n\n    _                _      _   _          \n __| |___ ___ __ _ _(_)_ __| |_(_)___ _ _  \n/ _` / -_|_-\u003c/ _| '_| | '_ \\  _| / _ \\ ' \\ \n\\__,_\\___/__/\\__|_| |_| .__/\\__|_\\___/_||_|\n                      |_|                  \n       id3  mass tagger is a tool for listing and manipulating ID3 and Lyrics3\n       tags in multiple files. It can generate tag fields  from\t the  filename\n       and other variables, and/or rename files, using an intuitive syntax.\n\n       id3  currently supports old-style ID3v1 tags, Lyrics3v2, as well as the\n       more complex ID3v2 format.  This means its  use\tis  limited  to\t audio\n       files which use these formats, i.e. MPEG-1 Layer III.\n\n          _   _             \n ___ _ __| |_(_)___ _ _  ___\n/ _ \\ '_ \\  _| / _ \\ ' \\(_-\u003c\n\\___/ .__/\\__|_\\___/_||_/__/\n    |_|                     \n       Order of the options is only important where specified.\n\n       filespec ...\n\t      specifies the file(s) to be affected by the command.\n\n\t      When using wildcards, enclose the specification in quotes in or-\n\t      der for pattern matching to work; see SUBSTITUTION below.\n\n       -h, --help\n\t      show command line help\n\n       -V, --version\n\t      display version number and copyright\n\n       -v, --verbose\n\t      be verbose\n\n       -1     process/add ID3v1 tags.\n\n       -2     process/add ID3v2 tags.\n\n       -3     process/add Lyrics3 tags.\n\n\t      If more than one tag type is specified, they  are\t all  written,\n\t      and the left-most one that is found is used for variable substi-\n\t      tution. If no tag type is specified, id3 will by default attempt\n\t      to read ID3v2, Lyrics3 and ID3v1 tags in that order, only modify\n\t      existing ID3v2 and Lyrics3 tags, and modify/add ID3v1 tags.\n\n       -R, --recursive\n\t      searches recursively; When this is  enabled,  `*'\t wildcards  in\n\t      filespec will also match against directory separators. Normally,\n\t      this is not the case.\n\n       -M, --keep-time\n\t      preserve last modification time of files operated on\n\n       -X, --no-glob\n\t      disable internal globbing; as a consequence, the pattern\tmatch-\n\t      ing  functionality  will\tnot  be available.  Use this switch to\n\t      force the treatment of filespec arguments as  simple  filenames,\n\t      which might be useful if id3 is being called by shell scripts or\n\t      other programs\n\n       --     force the following argument to be interpreted  as  a  filename.\n\t      Use this for files that start with a `-' (dash).\n\n   Modifying operations\n       The default operation of id3 is to list the tags found. By using any of\n       the following options, this behaviour is inhibited.\n\n       -d, --delete\n\t      do not re-use existing tag data. If no new  tag  information  is\n\t      specified\t in  conjunction  with\tthis option, all selected tags\n\t      will be removed.\n\n       -t title,\t       --title title\n       -a artist,\t       --artist artist\n       -l album,   -A album,   --album album\n       -n tracknr, -T tracknr, --track tracknr\n       -y year,\t\t       --year year\n       -g genre,\t       --genre genre\n       -c comment,\t       --comment comment\n\n\t      add/replace the specified fields in all selected tags  with  the\n\t      values  given.  Field  values are scanned for substitution vari-\n\t      ables, see SUBSTITUTION below. If a  field  value\t is  a\tsingle\n\t      variable, and its substitution fails, no operation is performed.\n\n\t      Genres  can  be  specified either verbatim or by using their as-\n\t      signed number, regardless of tag format.\n\n       -f filename-template, --rename filename-template\n\t      rename files encountered according  to  filename-template.   The\n\t      argument\tis  scanned for substitution variables. An empty vari-\n\t      able will by default get replaced with \"Unknown\".\t Trying to re-\n\t      name to an already existing file will cause an error.\n\n       -q format, --query format\n\t      for each file encountered, format will get scanned for substitu-\n\t      tion variables, and written to standard output. Using  this  op-\n\t      tion will block any attempt to modify files.\n\n       -m, --match\n\t      match  mode; interpret any substitution variables (see SUBSTITU-\n\t      TION below) found in a filespec as a wildcard, and set the  cor-\n\t      responding tag field to the matched portion of the filename.\n\n\t      Thus,    `id3   -m \"%a - %t.mp3\"'\t  is   short-hand   for\t  `id3\n\t      -a %1 -t %2 \"* - *.mp3\"'.\n\n       -D filename, --duplicate filename\n\t      duplicate and copy the tags found\t in  filename  to  the\ttarget\n\t      files.  The  tag in each target file is replaced after any vari-\n\t      ables have been read, but before any fields are updated.\n\n\t      Any original tag values not explicitly written to\t the  new  tag\n\t      (for  example,  by using -u) are lost. If filename does not have\n\t      any tags, this option is identical to the -d option.\n\n       -L, --list-genres\n\t      produces a list of genres usable in ID3v1 tags,  and  their  as-\n\t      signed numbers\n\n       The  following options only apply on the tag most recently selected be-\n       fore them, and only have meaning where relevant.\n\n       -E, --if-exists\n\t      only write a tag of the most recently selected type  if  a  file\n\t      already contains it; do not add new ones.\n\n       -u, --update\n\t      update  all  standard tag fields by copying them from the source\n\t      tag. This is similar to writing `-talnygc %t %a %l %n %y %g %c',\n\t      but only operates on the most recent tag. It is possible for the\n\t      source and destination tag to be the same.\n\n       -s size, --size size\n\t      try to write a new tag using exactly size bytes, adding / remov-\n\t      ing padding as necessary. The resulting tag will have no padding\n\t      if size is smaller than the actual size necessary.\n\n       -rFRAME, --remove=FRAME\n\t      remove occurrences of frames named FRAME from the\t tag.  Consult\n\t      the  format  documentation  for  valid  FRAME  names.   For text\n\t      frames, it is equivalent to `-wFRAME \"\"'.\n\n       -wFRAME data, --frame=FRAME data\n\t      add / update a frame named FRAME with data in the\t tag.  data is\n\t      scanned  for  substitution  variables. Again, consult the format\n\t      documentation. See COMPATIBILITY for more information.\n\n       Short-form options can be stacked in a single argument for more\tconve-\n       nience.\tFor example, running\n\n\t  id3 -2d -alt \"Artist\" \"Album\" \"Title\" *.mp3\n\n       is equivalent to:\n\n\t  id3 -2 -d -a \"Artist\" -l \"Album\" -t \"Title\" *.mp3\n\n         _       _   _ _        _   _          \n ____  _| |__ __| |_(_) |_ _  _| |_(_)___ _ _  \n(_-\u003c || | '_ (_-\u003c  _| |  _| || |  _| / _ \\ ' \\ \n/__/\\_,_|_.__/__/\\__|_|\\__|\\_,_|\\__|_\\___/_||_|\n                                               \n       id3 can perform \"printf-like\" substitution on the values prior to writ-\n       ing them to a tag. Note that if you want to use pattern\tmatching,  you\n       HAVE  TO\t enclose  the  wildcard\t specification\ton the command line in\n       quotes to prevent your shell from expanding any wildcards.\n\n       \\c     escape sequence. \\n, \\r, \\t, \\v, \\f, \\b, \\a, get replaced as  in\n\t      C,  any other character will be stripped of any special meaning.\n\t      E.g., \\n becomes the newline character, \\\\ a single backslash.\n\n       %\u003cmodifiers\u003eN\n\t      where N \u003c- [0..9]\n\t      replaced with the portion of the file path matching the nth  `*'\n\t      (asterisk)  wildcard  in\tthe  file specification. 0 is taken to\n\t      mean 10.\n\n       %\u003cmodifiers\u003ec\n\t      where c \u003c- [a..z]\n\t      replaced by values according to the following table:\n\n\t      %t title\n\t      %a artist\n\t      %l album title\n\t      %n track number\n\t      %y year\n\t      %g genre\n\t      %c comment field\n\t      %f file name (without path)\n\t      %p path to filename\n\t      %x auto-increasing counter\n\t      %X file counter\n\n\t      Values get read (where applicable) from the source tag, which is\n\t      the  left-most tag selected on the command line, and reflect the\n\t      state of the file before any modifications  were\tmade.  If  the\n\t      source  value  is\t not  available, the variable fails.  \"%_p%_f\"\n\t      combines to the raw full path and file name. The \"%x\" value gets\n\t      increased every time it has been substituted inside the same di-\n\t      rectory, and is intended for auto-numbering. \"%X\" increases  for\n\t      every file processed.\n\n       %\u003cmodifiers\u003e{FRAME}\n\t      replaced\tby  the\t content  of  the  FRAME frame in the selected\n\t      source tag; any frame writeable with the -w option can be\t used;\n\t      see COMPATIBILITY for more information.\n\n       %%     replaced with a single \"%\", equivalent to \\%\n\n       %|text||alt text||...|?\n\t      substituted by the first text that was completely successful, or\n\t      fails as empty, see fall-backs below. This can  be  used\tas  an\n\t      all-or-nothing substitution. A lone \"%?\" always fails.\n\n   Available \u003cmodifiers\u003e (optional):\n       + (plus sign)\n\t      Capitalize the substituted value\n\n       - (minus sign)\n\t      Convert all characters to lowercase\n\n       _ (underscore)\n\t      Use  the\traw  value of the variable. Normally, substitution re-\n\t      places any underscores with spaces, and condenses\t empty\twhite-\n\t      space.\n\n       * (asterisk)\n\t      Split  the  variable into separate words by looking at the capi-\n\t      talization.\n\n       # (hash or pound sign)\n\t      Attempt to fit numeric values in the substituted string to a de-\n\t      sired width, by removing or adding leading zeros.\t Multiple hash\n\t      signs can be stacked to indicate the desired width. If there are\n\t      no numeric values, this modifier has no effect.\n\n       |fall-back|\n\t      If substitution for a variable fails, attempt fall-back instead.\n\t      fall-back itself may be empty or contain\tother  variables  (in-\n\t      cluding  other fall-backs). If fall-back contains variables that\n\t      fail, the fall-back fails and will not be used. If more than one\n\t      fall-back is provided, successive fall-backs are tried until one\n\t      succeeds.\n\n                         _        \n _____ ____ _ _ __  _ __| |___ ___\n/ -_) \\ / _` | '  \\| '_ \\ / -_|_-\u003c\n\\___/_\\_\\__,_|_|_|_| .__/_\\___/__/\n                   |_|            \n       Here are some examples of using id3 :\n\n       id3 -a \"Stallman\" -t \"Free Software Song\" fs_song.mp3\"\n\t      Add a simple tag to a file.\n\n       id3 muzak.mp3\n\t      List tag information in a file.\n\n       id3 -d *.mp3\n\t      Removes all ID3v1 tags from all mp3's.\n\n       id3 -2 -1u fs_song.mp3\n\t      Copy ID3v2 tag to ID3v1 tag in selected file.\n\n       id3 -D source.mp3 -1 -2 dest.mp3\n\t      Duplicate ID3v1 and ID3v2 tags of source.mp3\n\n       id3 -a \"TAFKAT\" -n \"%1\" -t \"%+2\" \"*. *.mp3\"\n\t      Update tag fields similar to this;\n\t\t-a \"TAFKAT\" -n \"01\" -t \"My Song\"  \"01. my_song.mp3\"\n\t\t-a \"TAFKAT\" -n \"02\" -t \"Untitled\" \"02. untitled.mp3\"\n\n       id3 -2 -f \"%a - %t.mp3\" blaet.mp3\n\t      Rename file to a standard format, using ID3v2 values.\n\n       id3 -a %t -t %a \"*.mp3\"\n\t      Swap artist and title fields in all mp3's.\n\n       id3 -2 -rAPIC -s 0 *.mp3\n\t      Removes embedded images and padding from all mp3's.\n\n       id3 -2d -u *.mp3\n\t      Rewrite ID3v2 tag while keeping only the basic fields.\n\n       id3 -2 -wUSLT \"foo, bar0alala!0 blaet.mp3\n\t      Adds an ID3v2 lyric frame to blaet.mp3.\n\n       id3 -v -g alt-rock -alnt \"The Author\" %1 %2 %3 \"Author - */(*) *.mp3\"\n\t      Process multiple directories at once.\n\n       id3 -v -g alt-rock -a \"The Author\" -m \"Author - %l/(%n) %t.mp3\"\n\t      Shorthand for the previous example.\n\n       id3 -2 -c \"Was: %_f\" -f \"%|Nobody|a - %|Untitled (%x)|t.mp3\" \"*.mp3\"\n\t      Rename with missing values replaced. Saves previous filename in the comments.\n\n       id3 -2 -q \"%|%{TPE2}||%{TXXX:ALBUM ARTIST}|?\"\n\t      Tries to print the \"album artist\" using two possible ID3v2 frames.\n\n       id3 -2 -q \"%| %a - %|Untitled|t || %t || %1 |?\" \"*.mp3\"\n\t      Generate a simple list of songs.\n\n          _          \n _ _  ___| |_ ___ ___\n| ' \\/ _ \\  _/ -_|_-\u003c\n|_||_\\___/\\__\\___/__/\n                     \n       The internal pattern matching emulates the normal pattern  matching  of\n       \"sh\". It supports ?, * and [].\n\n       A  shell\t pattern will never match a forward slash (\"/\") or a dot (\".\")\n       beginning a filename. Wildcards can be used for directories as well (to\n       arbitrary depths), in which case a search will be performed.\n\n       In  an  ambiguous  situation, the pattern matcher will always resolve a\n       \"*\" wildcard to the shortest possible sequence of tokens. This  differs\n       from  the  behavior  of\tregular\t expressions, however it tends to make\n       sense in the context of filenames.\n\n       Do NOT add ID3 tags to files for which it does not make sense, i.e, add\n       them  only  to  MP3  files. In particular, do not add ID3v2 tags to Ogg\n       files, since ID3v2 tags start at the beginning of the file.\n\n                         _   _ _    _ _ _ _        \n __ ___ _ __  _ __  __ _| |_(_) |__(_) (_) |_ _  _ \n/ _/ _ \\ '  \\| '_ \\/ _` |  _| | '_ \\ | | |  _| || |\n\\__\\___/_|_|_| .__/\\__,_|\\__|_|_.__/_|_|_|\\__|\\_, |\n             |_|                              |__/ \n       id3 has a built-in genre list of 192 genres. If you pass the -g parame-\n       ter  a  string  instead of a number when using ID3v1, id3 tries to find\n       the specified genre in this list,  and  selects\tthe  closest  possible\n       match  (if  any).  For  the  genre  numbers and exact spelling, use the\n       --list-genres option.  An empty or invalid genre is assigned the number\n       0.\n\n       The ID3v1 format only supports to the ISO-8859-1 (Latin 1) encoding. If\n       you need other Unicode characters, you need to use ID3v2 tags.\n\n       When using -2, id3 will write ID3v2.3 by default, unless a file is  al-\n       ready  tagged  with  the\t older ID3v2.2. id3 can read ID3v2.4 tags, but\n       these will be converted to ID3v2.3 when modified.\n\n       Furthermore, with ID3v2 tags, the -wFRAME option and %{FRAME} substitu-\n       tion  only  support the following ID3v2.2 (3 letter)/ID3v2.3 (4 letter)\n       frames: T??/T??? (text), W??/W??? (links), COM/COMM (comment), IPL/IPLS\n       (involved  people), ULT/USLT (lyrics), CNT/PCNT (numeric play counter),\n       POP/POPM (popularimeter) and USER (tos, v2.3 only).  Attempts to\t write\n       ID3v2.2 frames to ID3v2.3 or vice versa will be ignored.\n\n       Several\tID3v2  frames  can  be specialized with additional descriptors\n       (TXXX, WXXX, COMM, USLT). These can be read or written  using  the  ex-\n       tended  syntax -wFRAME:descriptor and %{FRAME:descriptor}.  Descriptors\n       are case sensitive and may contain whitespace.\tFor  frames  that  are\n       language-specific  (COMM, USLT), the form FRAME:descriptor:xxx may also\n       be used, where xxx is a three letter ISO-639-2  language\t code.\t Which\n       descriptors are meaningful is application-specific.\n\n       id3  does  not  support unnecessary ID3v2 features such as compression,\n       encryption, or embedding binary data (including image files).\n\n           _   _            \n __ _ _  _| |_| |_  ___ _ _ \n/ _` | || |  _| ' \\/ _ \\ '_|\n\\__,_|\\_,_|\\__|_||_\\___/_|  \n                            \n       Written by Marc R. Schoolderman \u003cinfo@squell.net\u003e.\n\n                      _      _   _   \n __ ___ _ __ _  _ _ _(_)__ _| |_| |_ \n/ _/ _ \\ '_ \\ || | '_| / _` | ' \\  _|\n\\__\\___/ .__/\\_, |_| |_\\__, |_||_\\__|\n       |_|   |__/      |___/         \n       This is free software; see the source for copying conditions. There  is\n       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR\n       PURPOSE.\n\n                    _         \n ___ ___ ___   __ _| |___ ___ \n(_-\u003c/ -_) -_) / _` | (_-\u003c/ _ \\\n/__/\\___\\___| \\__,_|_/__/\\___/\n                              \n       Program homepage: https://squell.github.io/id3\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquell%2Fid3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsquell%2Fid3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquell%2Fid3/lists"}