Miniphonic

Wraps the auphonic API in delicious Ruby for audio processing bliss.

Add this line to your application's Gemfile:

gem 'miniphonic'

And then execute:

$ bundle

Or install it yourself as:

$ gem install miniphonic

First, set up Miniphonic:

require 'miniphonic'

Miniphonic.configure do |m|
  m.user = "your username"
  m.password = "much secret wow"
end

Both, productions and presets, are API objects and share most methods. They are simple Ruby objects:

production = Miniphonic::Production.new
preset = Miniphonic::Preset.new

On the server side, those objects are identified by their uuid.

You usually get one by creating your API object on the server side:

production.create
# => production.uuid = "SjRqGhxKhK448Gs6AgAzcZ"

If you already have one, you can create a new API object with a uuid:

production = Miniphonic::Production.new("SjRqGhxKhK448Gs6AgAzcZ")

Run production.delete or preset.delete to delete on the server.

Usually, you actually want to do something useful, so you need to add some attributes to your API objects. Miniphonic exposes the "top level" of attributes in dot notation, the rest is handled by the appropriate data structures (hashes and arrays). Take a look at this page or {preset|production}_attributes.rb to see what you can do.

Quick example:

production.metadata[:title] = "Hello there, internet"
production.output_files << {format: "mp3"}

If you set attributes before running create, they will be sent with the creation request, otherwise, use object.update to set the attributes on the server side.

You can get attributes from the server (thus overwriting the one in your local API object!) by running get_attributes, provided your object already has a uuid.

If you run Miniphonic::Production.all or Miniphonic::Preset.all, you get an array of all API objects on ther server, already initialized with their uuids. If you need their attributes as well, you need to run get_attributes on each of them.

To upload a cover image to a production or preset, use

production.upload_cover("/path/to/image.jpg")
preset.upload_cover("yet/another/image.png")

and smile.

If you want to use a preset to create your production, use production.create_from_preset("a preset uuid").

You can upload an input file (to a production with a uuid) by running

production.upload_audio("path/to/file")

Or use one from an external service:

production.upload_audio_from_service("file.m4a","service_uuid")

Add outfiles:

production.output_files << {format: "mp3", basename: "my_file"}

Start and stop productions (if you have provided an input file and at least one output file):

production.start
production.stop

Presets have a lot less fancy methods than productions, but they work pretty much the same. One caveat: You can't create presets without setting preset.name first.

The auphonic API is pretty cool about returning information about itself. For example, you can get all your user data with Miniphonic.user_data or all available algorithms with Miniphonic.algorithms. More info here or in info.rb. (Heh.)

The auphonic API is not really complicated, but there's a lot you can do. Right now, Miniphonic should allow you to do most of the things the API does (as far as I know), but please let me know if something is missing. I'm @sirmarcel on Twitter, that's probably easiest way to get in touch.

Refer to the API docs, the specs and the appropriate classes for further information.

Do some good now.

<3

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