Project

vmix

0.0
No commit activity in last 3 years
No release in over 3 years
Ruby Client for VMIX REST API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.2.3
~> 1.8.4
~> 0.9.2.2
~> 3.12
~> 2.12
~> 1.9.0

Runtime

~> 0.10.0
 Project Readme

VmixRubyClient

Ruby wrapper for VMIX REST API

Installation

Add this line to your application's Gemfile:

gem 'vmix'

And then execute:

$ bundle

Or install it yourself as:

$ gem install vmix

Usage

require "rubygems"
require "vmix"

All methods require authentication

Vmix.configure do |config|
  # Endpoint = 'apis.vmixcore.com/apis'
  config.endpoint = REST_API_URL
  # You can choose HTTP Basic Authentication (:http_basic_auth)
  #     or Token Based Authentication (:token_auth)
  config.authentication = YOUR_AUTHENTICATION_METHOD
  # For read requests, only token is required for token-based authentication
  config.token = YOUR_VMIX_API_TOKEN
  # For read and write requests, HTTP Basic Authentication requires username and password
  config.account_id = YOUR_ACCOUNT_ID
  config.api_password = YOUR_API_PASSWORD
end

Initialize the Client

v = Vmix::Client.new(:method => :token, :token => 'your-vmix-api-token')

List available API method calls

v.available_api_methods

Access methods with options

response = v.getCollections

response = v.getMediaList(:start => 100, :alltime => 1)

Current Status

This currently only implements the token api (not basic auth api) - ie. read only

TODO

  • Implement basic auth api
  • Write tests
  • Improve documentation

Contributing

  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