Sha256: d6614025bb329ab474cb53674ba3126e5ee8f08f920fd5da41ee935b03ab5dc0
Contents?: true
Size: 1.83 KB
Versions: 8
Compression:
Stored size: 1.83 KB
Contents
ruby-mp3info
by Guillaume Pierronnet
* http://ruby-mp3info.rubyforge.org/
* http://rubyforge.org/projects/ruby-mp3info/
== DESCRIPTION:
ruby-mp3info read low-level informations and manipulate tags on
mp3 files.
== FEATURES/PROBLEMS:
* written in pure ruby
* read low-level informations like bitrate, length, samplerate, etc...
* read, write, remove id3v1 and id3v2 tags
* only 2.3 version is supported for writings id3v2 tags
== SYNOPSIS:
a good exercise is to read the test.rb to understand how the library works deeper
require "mp3info"
# read and display infos & tags
Mp3Info.open("myfile.mp3") do |mp3info|
puts mp3info
end
# read/write tag1 and tag2 with Mp3Info#tag attribute
# when reading tag2 have priority over tag1
# when writing, each tag is written.
Mp3Info.open("myfile.mp3") do |mp3|
puts mp3.tag.title
puts mp3.tag.artist
puts mp3.tag.album
puts mp3.tag.tracknum
mp3.tag.title = "track title"
mp3.tag.artist = "artist name"
end
Mp3Info.open("myfile.mp3") do |mp3|
# you can access four letter v2 tags like this
puts mp3.tag2.TIT2
mp3.tag2.TIT2 = "new TIT2"
# or like that
mp3.tag2["TIT2"]
# at this time, only COMM tag is processed after reading and before writing
# according to ID3v2#options hash
mp3.tag2.options[:lang] = "FRE"
mp3.tag2.COMM = "my comment in french, correctly handled when reading and writing"
end
# tags v2 will be read and written according to the :encoding settings
mp3 = Mp3Info.open("myfile.mp3", :encoding => 'utf-8')
== REQUIREMENTS:
* iconv
== INSTALL:
$ ruby install.rb config
$ ruby install.rb setup
# ruby install.rb install
or
# gem install ruby-mp3info
== LICENSE:
ruby
== TODO:
* encoder detection
* support for more tags in id3v2
* generalize id3v2 with other audio formats (APE, MPC, OGG, etc...)
Version data entries
8 entries across 8 versions & 1 rubygems