arbarlow / ruby-mp4info

A RubyGem for getting, setting and modifying mp4 tags, including drm'd mp4 and with artwork.

My Changes¶ ↑

This gem isn’t originally mine, but i’ve added things etc…

Bundler¶ ↑

The gem can now be used with bundler and by extension, Rails 3, just use…

gem “mp4info”, :git => “git://github.com/arbarlow/ruby-mp4info.git”, :require => “mp4info”

Introduction¶ ↑

MP4Info supports the reading of tags and file info from MP4 audio files. It is based on the Perl module MP4::Info (search.cpan.org/~jhar/MP4-Info/) Note: MP4Info does not currently support Unicode strings.

License¶ ↑

This program is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

Usage¶ ↑

With mp4info.rb in your load path, do:

require 'mp4info'

Once the library is loaded, an MP4Info object is created by sending an IO object to MP4Info#new. MP4Info also provides the MP4Info#open method, which takes String containing a filename.

file = "my_favorite_song.mp4"
info = MP4Info.open(file)

io_stream = File.new("that_other_song.m4a")
other_info = MP4Info.new(io_stream)

Once an MP4Info object is succesfully created, a number of tags are avalible:

* ALB   - Album
* APID  - Apple Store ID
* ART   - Artist
* CMT   - Comment
* COVR  - Album art (typically jpeg data)
* CPIL  - Compilation (boolean)
* CPRT  - Copyright statement
* DAY   - Year
* DISK  - Disk number & total (Array of two integers)
* GNRE  - Genre
* GRP   - Grouping
* NAM   - Title
* RTNG  - Rating (integer)
* TMPO  - Tempo (integer)
* TOO   - Encoder
* TRKN  - Track number & total (Array of two integers)
* WRT   - Author or composer

The following extra information about the audio file is also provided:

* VERSION   - MPEG version (=4)
* LAYER     - Doesn't really mean antyhing, but here in case we need it
              for compatibility with an MP3 library...
* BITRATE   - Bitrate in kbps (average for VBR files)
              The formula used to generate this seems a little suspect.
* FREQUENCY - Frequency in kHz
* SIZE      - Bytes in audio stream

* SECS  - Total seconds, rounded to nearest second
* MM    - Minutes
* SS    - Leftover seconds
* MS    - Leftover milliseconds, rounded to nearest millisecond
* TIME  - Time in MM:SS, rounded to nearest second

* COPYRIGHT	- Non-nil if audio is copyrighted
* ENCRYPTED	- Non-nil if audio data is encrypted

ruby-mp4info's Issues

It doesn't read the title from M4A files

It doesn't read the title from M4A files (from iTunes at least). The "NAM" property is always empty.

License

Hello,

I would like to know if i can use this Gem in a commercial app without releasing my app source ?

I see its licensed under GPL. Not sure if up to date.

Thanks

fails to read ART, ALB, etc. tags on ruby 1.9.2

with ruby 1.9.2, tags preceded by the copyright sign (ART, ALB, etc.) are no longer read

Bump Version and Publish

This looks like the official repository now, but rubygems is still serving 1.7.3 which was last updated in 2010 and does not contain the latest commits.

Can you bump the version and publish a new gem to rubygems?