{"id":13419147,"url":"https://github.com/robinst/taglib-ruby","last_synced_at":"2025-05-14T14:10:15.456Z","repository":{"id":1649734,"uuid":"2375509","full_name":"robinst/taglib-ruby","owner":"robinst","description":"Ruby interface for the TagLib C++ library, for reading and writing meta-data (tags) of many audio formats","archived":false,"fork":false,"pushed_at":"2024-10-28T08:46:45.000Z","size":1887,"stargazers_count":261,"open_issues_count":12,"forks_count":27,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-05-07T20:11:25.529Z","etag":null,"topics":["ruby","taglib"],"latest_commit_sha":null,"homepage":"https://robinst.github.io/taglib-ruby/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robinst.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","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},"funding":{"github":"robinst"}},"created_at":"2011-09-13T01:57:23.000Z","updated_at":"2025-04-05T11:14:00.000Z","dependencies_parsed_at":"2024-03-05T12:27:28.268Z","dependency_job_id":"1b26f7e6-bb8d-4b6f-8440-3e283e8e6114","html_url":"https://github.com/robinst/taglib-ruby","commit_stats":{"total_commits":416,"total_committers":11,"mean_commits":37.81818181818182,"dds":"0.34134615384615385","last_synced_commit":"9c4f7214f269d78cdc130f4da10faaf2b9332288"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinst%2Ftaglib-ruby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinst%2Ftaglib-ruby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinst%2Ftaglib-ruby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinst%2Ftaglib-ruby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robinst","download_url":"https://codeload.github.com/robinst/taglib-ruby/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254160557,"owners_count":22024571,"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":["ruby","taglib"],"created_at":"2024-07-30T22:01:11.972Z","updated_at":"2025-05-14T14:10:10.447Z","avatar_url":"https://github.com/robinst.png","language":"C++","readme":"# taglib-ruby\n\nRuby interface for the [TagLib C++ library][taglib], for reading and\nwriting meta-data (tags) of many audio formats.\n\nIn contrast to other libraries, this one wraps the full C++ API, not\nonly the minimal C API. This means that all tag data can be accessed,\ne.g. cover art of ID3v2 or custom fields of Ogg Vorbis comments.\n\n`taglib-ruby` currently supports the following:\n\n* Reading/writing common tag data of all formats that TagLib supports\n* Reading/writing ID3v1 and ID3v2 including ID3v2.4 and Unicode\n* Reading/writing Ogg Vorbis comments\n* Reading/writing MP4 tags (.m4a)\n* Reading audio properties (e.g. bitrate) of the above formats\n\nContributions for more coverage of the library are very welcome.\n\n[![Gem version][gem-img]][gem-link]\n[![ci](https://github.com/robinst/taglib-ruby/workflows/ci/badge.svg)](https://github.com/robinst/taglib-ruby/actions?query=workflow%3Aci)\n\n## Installation\n\nBefore you install the gem, make sure to have [taglib 1.11.1 or higher][taglib]\ninstalled with header files (and a C++ compiler of course):\n\n* Debian/Ubuntu: `sudo apt-get install libtag1-dev`\n* Fedora/RHEL: `sudo dnf install taglib-devel`\n* Brew: `brew install taglib`\n* MacPorts: `sudo port install taglib`\n\nThen install the latest taglib-ruby 1.x by running:\n\n    gem install taglib-ruby --version '\u003c 2'\n\nIf you are using TagLib 2.0.1 or higher, you need to install taglib-ruby 2.x instead:\n\n    gem install taglib-ruby --version '\u003e= 2'\n\n### MacOS\n\nDepending on your brew setup, TagLib might be installed in different locations,\nwhich makes it hard for taglib-ruby to find it. To get the library location, run:\n\n    $ brew info taglib\n    taglib: stable 1.13 (bottled), HEAD\n    Audio metadata library\n    https://taglib.org/\n    /opt/homebrew/Cellar/taglib/1.13 (122 files, 1.6MB) *\n    ...\n\nNote the line with the path at the end. Provide that using the `TAGLIB_DIR`\nenvironment variable when installing, like this:\n\n    TAGLIB_DIR=/opt/homebrew/Cellar/taglib/1.13 gem install taglib-ruby\n\nIf you're using bundler, like this:\n\n    TAGLIB_DIR=/opt/homebrew/Cellar/taglib/1.13 bundle install\n\nAnother problem might be that `clang++` doesn't work with a specific version\nof TagLib. In that case, try compiling taglib-ruby's C++ extensions with a\ndifferent compiler:\n\n    TAGLIB_RUBY_CXX=g++-4.2 gem install taglib-ruby\n\n## Usage\n\nComplete API documentation can be found on\n[rubydoc.info](http://rubydoc.info/gems/taglib-ruby/frames).\n\nBegin with the `TagLib` namespace.\n\n## Release Notes\n\nSee [CHANGELOG.md](CHANGELOG.md).\n\n## Contributing\n\n### Dependencies\n\nFedora:\n\n    sudo dnf install taglib-devel ruby-devel gcc-c++ redhat-rpm-config swig\n\n### Building\n\nInstall dependencies (uses bundler, install it via `gem install bundler`\nif you don't have it):\n\n    bundle install\n\nRegenerate SWIG wrappers if you made changes in `.i` files (use version 3.0.7 of\nSWIG - 3.0.8 through 3.0.12 will not work):\n\n    rake swig\n\nForce regeneration of all SWIG wrappers:\n\n    touch ext/*/*.i\n    rake swig\n\nCompile extensions:\n\n    rake clean compile\n\nRun tests:\n\n    rake test\n\nRun irb with library:\n\n    irb -Ilib -rtaglib\n\nBuild and install gem into system gems:\n\n    rake install\n\nBuild a specific version of Taglib:\n\n    PLATFORM=x86_64-linux TAGLIB_VERSION=1.11.1 rake vendor\n\nThe above command will automatically download Taglib 1.11.1, build it and\ninstall it in `tmp/x86_64-linux/taglib-1.11.1`.\n\nThe `swig`, `compile` and `test` tasks can then be executed against that specific\nversion of Taglib by setting the `TAGLIB_DIR` environment variable to\n`$PWD/tmp/x86_64-linux/taglib-1.11.1` (it is assumed that taglib headers are\nlocated at `$TAGLIB_DIR/include` and taglib libraries at `$TAGLIB_DIR/lib`).\n\nTo do everything in one command:\n\n    PLATFORM=x86_64-linux TAGLIB_VERSION=1.11.1 TAGLIB_DIR=$PWD/tmp/x86_64-linux/taglib-1.11.1 rake vendor compile test\n\n### Workflow\n\n* Check out the latest `main` branch to make sure the feature hasn't been\n  implemented or the bug hasn't been fixed yet.\n* Check out the issue tracker to make sure someone hasn't already\n  requested it and/or contributed it.\n* Fork the project.\n* Start a feature/bugfix branch from `main`.\n* Commit and push until you are happy with your contribution.\n* Make sure to add tests for it. This is important so that I don't break it\n  in a future version unintentionally.\n* Run `rubocop` locally to lint your changes and fix the issues. Please refer to\n  [.rubocop.yml](.rubocop.yml) for the list of relaxed rules. Try to keep the\n  liniting offenses to minimum. Preferably, first run `rubocop` on your fork to\n  have a general idea of the existing linting offenses before writing new code.\n* Please try not to mess with the Rakefile, version, or history. If you\n  want to have your own version, or is otherwise necessary, that is\n  fine, but please isolate to its own commit so I can cherry-pick around\n  it.\n\n## License\n\nCopyright (c) 2010-2022 Robin Stocker and others, see Git history.\n\n`taglib-ruby` is distributed under the MIT License, see\n[LICENSE.txt](LICENSE.txt) for details.\n\nIn the binary gem for Windows, a compiled [TagLib][taglib] is bundled as\na DLL. TagLib is distributed under the GNU Lesser General Public License\nversion 2.1 (LGPL) and Mozilla Public License (MPL).\n\n[taglib]: http://taglib.github.io/\n[gem-img]: https://badge.fury.io/rb/taglib-ruby.svg\n[gem-link]: https://rubygems.org/gems/taglib-ruby\n","funding_links":["https://github.com/sponsors/robinst"],"categories":["TODO scan for Android support in followings","C++"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobinst%2Ftaglib-ruby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobinst%2Ftaglib-ruby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobinst%2Ftaglib-ruby/lists"}