{"id":18344325,"url":"https://github.com/notryanb/nu_plugin_id3","last_synced_at":"2025-04-06T07:33:02.930Z","repository":{"id":54524467,"uuid":"237115677","full_name":"notryanb/nu_plugin_id3","owner":"notryanb","description":"A Nushell plugin to get Id3 tag information as structured data.","archived":false,"fork":false,"pushed_at":"2021-02-12T23:08:41.000Z","size":5955,"stargazers_count":6,"open_issues_count":6,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-21T20:46:36.394Z","etag":null,"topics":["id3","nushell","plugin"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/notryanb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-01-30T01:15:38.000Z","updated_at":"2021-02-28T18:48:20.000Z","dependencies_parsed_at":"2022-08-13T18:40:18.157Z","dependency_job_id":null,"html_url":"https://github.com/notryanb/nu_plugin_id3","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notryanb%2Fnu_plugin_id3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notryanb%2Fnu_plugin_id3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notryanb%2Fnu_plugin_id3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notryanb%2Fnu_plugin_id3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/notryanb","download_url":"https://codeload.github.com/notryanb/nu_plugin_id3/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247450745,"owners_count":20940938,"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":["id3","nushell","plugin"],"created_at":"2024-11-05T21:05:36.583Z","updated_at":"2025-04-06T07:33:02.507Z","avatar_url":"https://github.com/notryanb.png","language":"Rust","readme":"# nu_plugin_id3\n\nThe `id3` is a plugin for [nushell](https://www.nushell.sh) that helps you read the [id3](https://en.wikipedia.org/wiki/ID3) metadata of your mp3 files.\nThis is project is experimental and still under development.\nThe public API for the user (flags, command input, etc...) may change while [nushell](https://www.nushell.sh) is still pre `1.0`.\n\n![Example of id3](images/nushell.gif \"Example of id3\")\n\nThis project is still lacking many features\n- Ability to parse Id3V1 tags\n- Show tag version information\n- Eliminate non-mp3 files from the output (nu command `compact` removes empty rows)\n- Missing several Id3V2 fields such as comments, data recorded, etc...\n- Ability to write to the tag (mutate artist, album, comments, lyrics, etc...)\n- Ability to convert from older Id3V1 to Id3V2.X\n\n## Installation\n\nThis project depends on a minimum of [nushell](https://www.nushell.sh) `0.10.0` to be installed as that is when support for plugin names containing numbers started.\n\n### Cargo\n`cargo install nu_plugin_id3`\n\n## Build from Source\n- Clone this repository and navigate to the project directory\n- `cargo install --path .`\n- You may need to restart nushell for it to recognize this plugin.\n\n## Usage\n\n`id3` will recursively walk a directory and try to parse id3 tags for each file it finds.\nThe only parameter `id3` takes is an optional path.\nIf no optional path is given, `id3` will search the current directory.\nYou may specify an arbitrary directory or path to search.\n\n```\n// Searches the present working directory\nid3\n```\n\n```\n// Searches all directories inside of ~/mp3s/fugazi\nid3 ~/mp3s/fugazi\n```\n\nTo take advantage of some fun features of [nushell](https://www.nushell.sh) like viewing images in your terminal,\nyou'll need to have the `binaryview` plugin installed with [nushell](https://www.nushell.sh).\nYou can install this via `cargo install nu_plugin_binaryview`.\n\n```\n// :)\nid3 ~/mp3s/fugazi/repeater | get pictures | first | get data\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnotryanb%2Fnu_plugin_id3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnotryanb%2Fnu_plugin_id3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnotryanb%2Fnu_plugin_id3/lists"}