Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Ruby api for the AtomicParsley cli.

branch: master


A wrapper api for the atomicparsley cli. Made for scripting out bulk media meta encodings in ruby. It has been tested on mp3, mp4, and m4v.


    brew install AtomicParsley
    sudo apt-get install AtomicParsley
    install Linux

Add this line to your application's Gemfile:

gem 'atomic-parsley-ruby'

And then execute:

$ bundle

Or install it yourself as:

$ gem install atomic-parsley-ruby


# You can set any of the following attributes on the media class.
#  artist       (string)     Set the artist tag
#  title        (string)     Set the title tag
#  album        (string)     Set the album tag
#  genre        (string)     Genre tag (see longhelp for more info)
#  tracknum     (num)[/tot]  Track number (or track number/total tracks)
#  disk         (num)[/tot]  Disk number (or disk number/total disks)
#  comment      (string)     Set the comment tag
#  year         (num|UTC)    Year tag (see longhelp for \"Release Date\")
#  lyrics       (string)     Set lyrics (not subject to 256 byte limit)
#  composer     (string)     Set the composer tag
#  copyright    (string)     Set the copyright tag
#  grouping     (string)     Set the grouping tag
#  artwork      (/path)      Set a piece of artwork (jpeg or png only)
#  bpm          (number)     Set the tempo/bpm
#  albumArtist  (string)     Set the album artist tag
#  compilation  (boolean)    Set the compilation flag (true or false)
#  hdvideo      (boolean)    Set the hdvideo flag (true or false)
#  advisory     (string*)    Content advisory (*values: 'clean', 'explicit')
#  stik         (string*)    Sets the iTunes \"stik\" atom (see longhelp)
#  description  (string)     Set the description tag
#  longdesc     (string)     Set the long description tag
#  TVNetwork    (string)     Set the TV Network name
#  TVShowName   (string)     Set the TV Show name
#  TVEpisode    (string)     Set the TV episode/production code
#  TVSeasonNum  (number)     Set the TV Season number
#  TVEpisodeNum (number)     Set the TV Episode number
#  podcastFlag  (boolean)    Set the podcast flag (true or false)
#  category     (string)     Sets the podcast category
#  keyword      (string)     Sets the podcast keyword
#  podcastURL   (URL)        Set the podcast feed URL
#  podcastGUID  (URL)        Set the episode's URL tag
#  purchaseDate (UTC)        Set time of purchase
#  encodingTool (string)     Set the name of the encoder
#  encodedBy    (string)     Set the name of the Person/company who encoded the file
#  apID         (string)     Set the Account Name
#  cnID         (number)     Set the iTunes Catalog ID (see longhelp)
#  xid          (string)     Set the vendor-supplied iTunes xID (see --longhelp)
#  gapless      (boolean)    Set the gapless playback flag
#  contentRating (string)   Set tv/mpaa rating (see -rDNS-help)
#  overwrite    (boolean)    Overwrite media file, instead of create a temp file (true or false) (default: false)

v ="test.mp4")

v.artist "Some Guy"
v.year "2012"
v.genre "Punk Rock"
v.artwork "cover.png"

# you can also use the block format below.

v.encode do |config|
    config.artist "Some Guy"
    config.year "2012"
    config.genre "Punk Rock"
    config.artwork "cover.png"


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
Something went wrong with that request. Please try again.