skyjam 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b72293adf1cb2d6ca7d3e9304e692a4e7d7b5f78
+  data.tar.gz: b9fccfea53692433410e312b21e4a40089bd55f9
+SHA512:
+  metadata.gz: 2f96ff58ba7b7248818fb5771f5998083e9216c512a1db101ce08a4798d2d868e1d050e81cf66d7871acde34a1d53b44141efdc8b876f81dadb1cd25b2227d3d
+  data.tar.gz: 7b20cb56b5e4f7cfc8726f4a4f338002867c4da7a10e907697cc5b74e6f674d2fda2708f177bcc3549489a5934aa28d002ee2b16050aadcdb558139905b40b7f

data/LICENSE

@@ -0,0 +1,24 @@
+Copyright (C) 2013 Loic Nageleisen
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the copyright holders nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,86 @@
+# ruby-skyjam
+
+Deftly interact with Google Music (a.k.a Skyjam)
+
+## Important foreword
+
+This uses the same *device id* as *Google's Music Manager* (your MAC address).
+The reason is that incrementing the MAC is not a globally solving solution
+and that you most probably won't need Google's Music Manager afterwards
+because it's, well, “lacking” (to say the least). This may apply to the
+*Chrome extension* too but I'm not sure so you'd be best not using it (it's
+similarly lacking anyway).
+
+## On the command line
+
+```bash
+gem install skyjam     # install the gem
+skyjam --auth          # authenticates with OAuth, do it only once
+skyjam ~/Music/Skyjam  # download files into the specified directory
+```
+
+Existing files will not be overwritten, so that makes
+a nice sync/resume solution. Tracks are downloaded atomically, so
+you're safe to `^C`.
+
+## Inside ruby
+
+Add 'skyjam' to your `Gemfile` (you *do* use Gemfiles?)
+
+Here's a sample of what you can do now:
+
+```ruby
+require 'skyjam'
+
+# where you want to store your library
+path = File.join(ENV['HOME'], 'Music/Skyjam')
+
+# Interactive authentication, only needed once.
+# This performs OAuth and registers the device
+# into Google Music services. Tokens are persisted
+# in ~/.config/skyjam
+Skyjam::Library.auth
+
+# Connect the library to Google Music services
+# This performs an OAuth refresh with persisted
+# tokens
+lib = Skyjam::Library.connect(path)
+
+puts lib.tracks.count
+
+lib.tracks.take(5).each { |t| puts t.title }  # metadata is exposed as accessors
+
+track = lib.tracks.first
+track.download               # atomically download track into the library
+track.download               # noop, since now the file exists
+track.download(lazy: false)  # forces the download
+
+track.data                # returns track audio data from the file (since it's downloaded)
+track.data(remote: true)  # forces remote data fetching
+```
+
+The following snippet also makes for an interesting interactive
+REPL to interact with Google Music, wich is a testament to the
+clarity aimed at in this project:
+
+```ruby
+require 'skyjam'
+require 'pry'
+Skyjam::Library.connect('some/where').pry
+```
+
+## Future features
+
+Yes, trouble free upload for the quality minded is coming.
+
+Also, see [TODO](TODO.md).
+
+## Goals
+
+Have a potent tool that doubles as a library and a documentation
+of the Google Music API (including ProtoBuf definitions)
+
+## References
+
+* [Simon Weber's Unofficial Google Music API](https://github.com/simon-weber/Unofficial-Google-Music-API/)
+* [Google Music protocol reverse engineering effort](http://www.verious.com/code/antimatter15/google-music-protocol/) (disappeared)

data/Rakefile

@@ -0,0 +1,6 @@
+load 'protobuf/tasks/compile.rake'
+
+task :compile do
+  args = %w(skyjam defs lib ruby .pb.rb)
+  ::Rake::Task['protobuf:compile'].invoke(*args)
+end

data/bin/skyjam

@@ -0,0 +1,51 @@
+#!/usr/bin/env ruby
+
+require 'skyjam'
+require 'rainbow'
+require 'rainbow/ext/string'
+
+if ARGV.size != 1
+  $stderr.puts('usage: skyjam [--auth | library_path]')
+  exit(1)
+end
+
+module SkyJam
+  path = ARGV.last
+
+  if ARGV[0] == '--auth'
+    path = nil if path == '--auth'
+    rc = Library.auth(path) ? 0 : 1
+    exit(rc)
+  end
+
+  begin
+    lib = Library.connect(path)
+  rescue Client::Error => e
+    $stderr.puts("error: #{e.message}")
+    exit(1)
+  end
+
+  begin
+    success = failed = 0
+
+    lib.tracks.each.with_index do |track, i|
+      begin
+        $stdout.write("    %05d #{track.title}" % i)
+        $stdout.flush
+        track.download(lazy: true)
+      rescue Client::Error
+        $stdout.write("\r" + 'NOK'.color(:red))
+        failed += 1
+      else
+        $stdout.write("\r" + ' OK'.color(:green))
+        success += 1
+      end
+      $stdout.write("\n")
+    end
+  ensure
+    $stdout.write("\n")
+    $stdout.write("summary: success %s | failed: %s\n" %
+                  [success.to_s.color(:green),
+                   failed.to_s.color(:red)])
+  end
+end

data/lib/skyjam/client.rb

@@ -0,0 +1,289 @@
+module SkyJam
+  class Client
+    class Error < StandardError; end
+
+    def initialize
+      @base_url = 'https://play.google.com/music/'
+      @service_url = @base_url + 'services/'
+      @android_url = 'https://android.clients.google.com/upsj/'
+
+      load_config
+    end
+
+    ### Simple auth
+    # login: with app-specific password, obtain auth token
+    # cookie: with auth token, obtain cross token (xt)
+    # loadalltracks: with auth token and cross token, obtain list of tracks
+
+    def login
+      uri = URI('https://www.google.com/accounts/ClientLogin')
+
+      q = { 'service'      => 'sj',
+            'account_type' => 'GOOGLE',
+            'source'       => 'ruby-skyjam-%s' % SkyJam::VERSION,
+            'Email'        => @account,
+            'Passwd'       => @password }
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+
+      req = Net::HTTP::Post.new(uri.path)
+      req.set_form_data(q)
+      res = http.request(req)
+
+      unless res.is_a? Net::HTTPSuccess
+        fail Error, 'login failed: #{res.code}'
+      end
+
+      tokens = Hash[*res.body
+                        .split("\n")
+                        .map { |r| r.split('=', 2) }
+                        .flatten]
+      @sid = tokens['SID']
+      @auth = tokens['Auth']
+    end
+
+    def cookie
+      uri = URI(@base_url + 'listen')
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+
+      req = Net::HTTP::Head.new(uri.path)
+      req['Authorization'] = 'GoogleLogin auth=%s' % @auth
+      res = http.request(req)
+
+      unless res.is_a? Net::HTTPSuccess
+        fail Error, 'cookie failed: #{res.code}'
+      end
+
+      h = res.to_hash['set-cookie']
+             .map { |e| e =~ /^xt=([^;]+);/ and $1 }
+             .compact.first
+      @cookie = h
+    end
+
+    ## Web Client API
+
+    def loadalltracks
+      uri = URI(@service_url + 'loadalltracks')
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+
+      req = Net::HTTP::Post.new(uri.path)
+      req.set_form_data('u' => 0, 'xt' => @cookie)
+      req['Authorization'] = 'GoogleLogin auth=%s' % @auth
+      res = http.request(req)
+
+      unless res.is_a? Net::HTTPSuccess
+        fail Error, 'loadalltracks failed: #{res.code}'
+      end
+
+      JSON.parse(res.body)
+    end
+
+    ## OAuth2
+    # https://developers.google.com/accounts/docs/OAuth2InstalledApp
+    # https://code.google.com/apis/console
+
+    def oauth2_access
+      { client_id: '256941431767.apps.googleusercontent.com',
+        client_secret: 'oHTZP8zhh7E8wF6NWsiDULhq' }
+    end
+
+    def oauth2_endpoint
+      { site: 'https://accounts.google.com',
+        authorize_url: '/o/oauth2/auth',
+        token_url: '/o/oauth2/token' }
+    end
+
+    def oauth2_request
+      { scope: 'https://www.googleapis.com/auth/musicmanager',
+        access_type: 'offline',
+        approval_prompt: 'force',
+        redirect_uri: 'urn:ietf:wg:oauth:2.0:oob' }
+    end
+
+    def oauth2_client
+      @oauth2_client ||= OAuth2::Client.new(oauth2_access[:client_id],
+                                            oauth2_access[:client_secret],
+                                            oauth2_endpoint)
+      @oauth2_client
+    end
+
+    def oauth2_setup
+      # ask for OOB auth code
+      puts oauth2_client.auth_code.authorize_url(oauth2_request)
+      # user gives code
+      puts 'code: '
+      code = $stdin.gets.chomp.strip
+      # exchange code for access token and refresh token
+      uri = oauth2_request[:redirect_uri]
+      access = oauth2_client.auth_code.get_token(code,
+                                                 redirect_uri: uri,
+                                                 token_method: :post)
+      puts 'access: '  + access.token
+      puts 'refresh: ' + access.refresh_token
+      # expires_in
+      # token_type: Bearer
+      @oauth2_access_token = access
+    end
+
+    def oauth2_persist(filename)
+      File.open(filename, 'wb') do |f|
+        f.write(YAML.dump(refresh_token: @oauth2_access_token.refresh_token))
+      end
+    end
+
+    def oauth2_restore(filename)
+      token_h = YAML.load(File.read(filename))
+      oauth2_login(token_h[:refresh_token])
+    end
+
+    def oauth2_login(refresh_token)
+      @oauth2_access_token = OAuth2::AccessToken
+                              .from_hash(oauth2_client,
+                                         refresh_token: refresh_token)
+      oauth2_refresh_access_token
+    end
+
+    def oauth2_refresh_access_token
+      @oauth2_access_token = @oauth2_access_token.refresh!
+    end
+
+    def oauth2_access_token_expired?
+      @oauth2_access_token.expired?
+    end
+
+    def oauth2_authentication_header
+      @oauth2_access_token.options[:header_format] % @oauth2_access_token.token
+    end
+
+    ## MusicManager Uploader identification
+
+    def mac_addr
+      case RUBY_PLATFORM
+      when /darwin/
+        if (m = `ifconfig en0`.match(/ether (\S{17})/))
+          m[1].upcase
+        end
+      end
+    end
+
+    def hostname
+      `hostname`.chomp.gsub(/\.local$/, '')
+    end
+
+    def uploader_id
+      mac_addr.gsub(/\d{2}$/) { |s| '%02X' % s.hex }
+    end
+
+    def uploader_name
+      "#{hostname} (ruby-skyjam-#{VERSION})"
+    end
+
+    def uploader_auth
+      # {'User-agent': 'Music Manager (1, 0, 55, 7425 HTTPS - Windows)'}'
+      # uploader_id uploader_name
+      pb_body = MusicManager::AuthRequest.new
+      pb_body.id = uploader_id
+      pb_body.name = uploader_name
+
+      uri = URI(@android_url + 'upauth')
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+
+      req = Net::HTTP::Post.new(uri.path)
+      req.body = pb_body.serialize_to_string
+      req['Content-Type'] = 'application/x-google-protobuf'
+      req['Authorization'] = oauth2_authentication_header
+      res = http.request(req)
+
+      unless res.is_a? Net::HTTPSuccess
+        fail Error, 'uploader_auth failed: #{res.code}'
+      end
+
+      MusicManager::Response.new.parse_from_string(res.body)
+    end
+
+    ## MusicManager API
+
+    def listtracks(continuation_token: nil)
+      oauth2_refresh_access_token if oauth2_access_token_expired?
+
+      pb_body = MusicManager::ExportTracksRequest.new
+      pb_body.client_id = uploader_id
+      pb_body.export_type = MusicManager::ExportTracksRequest::TrackType::ALL
+      pb_body.continuation_token = continuation_token unless continuation_token.nil?
+
+      uri = URI('https://music.google.com/music/exportids')
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+
+      req = Net::HTTP::Post.new(uri.path)
+      req.body = pb_body.serialize_to_string
+      req['Content-Type'] = 'application/x-google-protobuf'
+      req['Authorization'] = oauth2_authentication_header
+      req['X-Device-ID'] = uploader_id
+      res = http.request(req)
+
+      unless res.is_a? Net::HTTPSuccess
+        fail Error, 'listtracks failed: #{res.code}'
+      end
+
+      MusicManager::ExportTracksResponse.new.parse_from_string(res.body)
+    end
+
+    def download_url(song_id)
+      uri = URI('https://music.google.com/music/export')
+      q = { version: 2, songid: song_id }
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+
+      qs = q.map { |k, v| "#{k}=#{v}" }.join('&')
+      req = Net::HTTP::Get.new(uri.path + '?' + qs)
+      req['Authorization'] = oauth2_authentication_header
+      req['X-Device-ID'] = uploader_id
+      res = http.request(req)
+
+      unless res.is_a? Net::HTTPSuccess
+        fail Error, 'download_url failed: #{res.code}'
+      end
+
+      JSON.parse(res.body)['url']
+    end
+
+    def download_track(url)
+      uri = URI(url)
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+
+      req = Net::HTTP::Get.new(uri.path + '?' + uri.query)
+      req['Authorization'] = oauth2_authentication_header
+      #req['User-Agent'] = 'Music Manager (1, 0, 55, 7425 HTTPS - Windows)'
+      req['X-Device-ID'] = uploader_id
+      res = http.request(req)
+
+      unless res.is_a? Net::HTTPSuccess
+        fail Error, 'download_track failed: #{res.code}'
+      end
+
+      res.body
+    end
+
+    def read_config
+      YAML.load(File.read('auth.yml'))
+    end
+
+    def load_config
+      config = read_config
+      @account = config['account']
+      @password = config['password']
+    end
+  end
+end

data/lib/skyjam/library.rb

@@ -0,0 +1,77 @@
+module SkyJam
+  class Library
+    class << self
+      def auth(path = nil)
+        config = auth_config(path) || default_auth_config
+
+        client = Client.new
+        client.oauth2_setup
+        client.uploader_auth
+
+        FileUtils.mkdir_p(File.dirname(config))
+        client.oauth2_persist(config)
+      end
+
+      def connect(path)
+        library = new(path)
+
+        config = default_auth_config if File.exist?(default_auth_config)
+        config = auth_config(path) if File.exist?(auth_config(path))
+
+        fail Client::Error, 'no auth' if config.nil?
+
+        library.instance_eval do
+          @client = Client.new
+          @client.oauth2_restore(config)
+        end
+
+        library
+      end
+
+      private
+
+      def default_auth_config
+        File.join(ENV['HOME'], '.config/skyjam/skyjam.auth.yml')
+      end
+
+      def auth_config(path)
+        File.join(path, '.skyjam.auth.yml') unless path.nil?
+      end
+    end
+
+    attr_reader :path
+
+    def initialize(path)
+      @path = path
+    end
+
+    def tracks
+      return @tracks unless @tracks.nil?
+
+      @tracks = []
+      continuation_token = nil
+
+      loop do
+        list = client.listtracks(continuation_token: continuation_token)
+
+        continuation_token = list[:continuation_token]
+
+        list[:track_info].each do |info|
+          track = SkyJam::Track.new(info)
+          library = self
+          track.instance_eval { @library = library }
+
+          @tracks << track
+        end
+
+        break if continuation_token == ''
+      end
+
+      @tracks
+    end
+
+    private
+
+    attr_reader :client
+  end
+end

data/lib/skyjam/music_manager/auth_request.pb.rb

@@ -0,0 +1,26 @@
+##
+# This file is auto-generated. DO NOT EDIT!
+#
+require 'protobuf/message'
+
+module SkyJam
+  module MusicManager
+
+    ##
+    # Message Classes
+    #
+    class AuthRequest < ::Protobuf::Message; end
+
+
+    ##
+    # Message Fields
+    #
+    class AuthRequest
+      required :string, :id, 1
+      optional :string, :name, 2
+    end
+
+  end
+
+end
+

data/lib/skyjam/music_manager/export_tracks_request.pb.rb

@@ -0,0 +1,35 @@
+##
+# This file is auto-generated. DO NOT EDIT!
+#
+require 'protobuf/message'
+
+module SkyJam
+  module MusicManager
+
+    ##
+    # Message Classes
+    #
+    class ExportTracksRequest < ::Protobuf::Message
+      class TrackType < ::Protobuf::Enum
+        define :ALL, 1
+        define :STORE, 2
+      end
+
+    end
+
+
+
+    ##
+    # Message Fields
+    #
+    class ExportTracksRequest
+      required :string, :client_id, 2
+      optional :string, :continuation_token, 3
+      optional ::SkyJam::MusicManager::ExportTracksRequest::TrackType, :export_type, 4
+      optional :int64, :updated_min, 5
+    end
+
+  end
+
+end
+

data/lib/skyjam/music_manager/export_tracks_response.pb.rb

@@ -0,0 +1,50 @@
+##
+# This file is auto-generated. DO NOT EDIT!
+#
+require 'protobuf/message'
+
+module SkyJam
+  module MusicManager
+
+    ##
+    # Message Classes
+    #
+    class ExportTracksResponse < ::Protobuf::Message
+      class Status < ::Protobuf::Enum
+        define :OK, 1
+        define :TRANSIENT_ERROR, 2
+        define :MAX_CLIENTS, 3
+        define :CLIENT_AUTH_ERROR, 4
+        define :CLIENT_REG_ERROR, 5
+      end
+
+      class TrackInfo < ::Protobuf::Message; end
+
+    end
+
+
+
+    ##
+    # Message Fields
+    #
+    class ExportTracksResponse
+      class TrackInfo
+        optional :string, :id, 1
+        optional :string, :title, 2
+        optional :string, :album, 3
+        optional :string, :album_artist, 4
+        optional :string, :artist, 5
+        optional :int32, :track_number, 6
+        optional :int64, :track_size, 7
+      end
+
+      required ::SkyJam::MusicManager::ExportTracksResponse::Status, :status, 1
+      repeated ::SkyJam::MusicManager::ExportTracksResponse::TrackInfo, :track_info, 2
+      optional :string, :continuation_token, 3
+      optional :int64, :updated_min, 4
+    end
+
+  end
+
+end
+

data/lib/skyjam/music_manager/response.pb.rb

@@ -0,0 +1,67 @@
+##
+# This file is auto-generated. DO NOT EDIT!
+#
+require 'protobuf/message'
+
+module SkyJam
+  module MusicManager
+
+    ##
+    # Message Classes
+    #
+    class Response < ::Protobuf::Message
+      class Type < ::Protobuf::Enum
+        define :METADATA, 1
+        define :PLAYLIST, 2
+        define :PLAYLIST_ENTRY, 3
+        define :SAMPLE, 4
+        define :JOBS, 5
+        define :AUTH, 6
+        define :CLIENT_STATE, 7
+        define :UPDATE_UPLOAD_STATE, 8
+        define :DELETE_UPLOAD_REQUESTED, 9
+      end
+
+      class AuthStatus < ::Protobuf::Enum
+        define :OK, 8
+        define :MAX_LIMIT_REACHED, 9
+        define :CLIENT_BOUND_TO_OTHER_ACCOUNT, 10
+        define :CLIENT_NOT_AUTHORIZED, 11
+        define :MAX_PER_MACHINE_USERS_EXCEEDED, 12
+        define :CLIENT_PLEASE_RETRY, 13
+        define :NOT_SUBSCRIBED, 14
+        define :INVALID_REQUEST, 15
+      end
+
+      class Status < ::Protobuf::Message
+        class Code < ::Protobuf::Enum
+          define :OK, 1
+          define :ALREADY_EXISTS, 2
+          define :SOFT_ERROR, 3
+          define :METADATA_TOO_LARGE, 4
+        end
+
+      end
+
+
+    end
+
+
+
+    ##
+    # Message Fields
+    #
+    class Response
+      class Status
+        required ::SkyJam::MusicManager::Response::Status::Code, :code, 1
+      end
+
+      optional ::SkyJam::MusicManager::Response::Type, :type, 1
+      optional ::SkyJam::MusicManager::Response::AuthStatus, :auth_status, 11
+      optional :bool, :auth_error, 12
+    end
+
+  end
+
+end
+

data/lib/skyjam/music_manager.pb.rb

@@ -0,0 +1,11 @@
+##
+# This file is auto-generated. DO NOT EDIT!
+#
+require 'protobuf/message'
+
+module SkyJam
+  module MusicManager
+  end
+
+end
+

data/lib/skyjam/music_manager.rb

@@ -0,0 +1,5 @@
+require 'skyjam/music_manager.pb.rb'
+require 'skyjam/music_manager/export_tracks_request.pb.rb'
+require 'skyjam/music_manager/export_tracks_response.pb.rb'
+require 'skyjam/music_manager/auth_request.pb.rb'
+require 'skyjam/music_manager/response.pb.rb'

data/lib/skyjam/track.rb

@@ -0,0 +1,104 @@
+require 'tempfile'
+
+module SkyJam
+  class Track
+    module Source
+      STORE = 1
+      UPLOAD = 2
+      MATCH = 6
+    end
+
+    attr_reader :id,
+                :title,
+                :album,
+                :album_artist,
+                :artist,
+                :number,
+                :size
+
+    def initialize(info)
+      @id = info[:id]
+      @title = info[:title]
+      @album = info[:album]
+      @album_artist = info[:album_artist] unless info[:album_artist].nil? || info[:album_artist].empty?
+      @artist = info[:artist]
+      @number = info[:track_number]
+      @size = info[:track_size]
+    end
+
+    def filename
+      escape_path_component("%02d - #{title}" % number) << extname
+    end
+
+    def extname
+      '.mp3'
+    end
+
+    def dirname
+      path_components = [library.path,
+                         escape_path_component(album_artist || artist),
+                         escape_path_component(album)]
+      File.join(path_components)
+    end
+
+    def path
+      File.join(dirname, filename)
+    end
+
+    def local?
+      File.exist?(path)
+    end
+
+    def download(lazy: false)
+      return if !lazy || (lazy && local?)
+
+      file = Tempfile.new(filename)
+      begin
+        file << data(remote: true)
+      rescue SkyJam::Client::Error
+        file.close!
+        raise
+      else
+        make_dir
+        FileUtils.mv(file.path, path)
+      end
+    end
+
+    def data(remote: false)
+      if remote || !local?
+        url = client.download_url(id)
+        client.download_track(url)
+      else
+        File.binread(path)
+      end
+    end
+
+    def upload
+      fail NotImplementedError
+    end
+
+    private
+
+    attr_reader :library
+
+    def client
+      library.send(:client)
+    end
+
+    def make_dir
+      FileUtils.mkdir_p(dirname)
+    end
+
+    def escape_path_component(component)
+      # OSX:   : -> FULLWIDTH COLON (U+FF1A)
+      # OSX:   / -> : (translated as / in Cocoa)
+      # LINUX: / -> DIVISION SLASH (U+2215)
+      component = component.dup
+
+      component.gsub!(':', "\uFF1A")
+      component.gsub!('/', ':')
+
+      component
+    end
+  end
+end

data/lib/skyjam/version.rb

@@ -0,0 +1,3 @@
+module SkyJam
+  VERSION = '0.5.0'
+end

data/lib/skyjam.rb

@@ -0,0 +1,15 @@
+require 'net/http'
+require 'net/https'
+require 'yaml'
+require 'json'
+require 'oauth2'
+require 'protobuf'
+
+require 'skyjam/version'
+require 'skyjam/music_manager'
+require 'skyjam/client'
+require 'skyjam/track'
+require 'skyjam/library'
+
+module SkyJam
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: skyjam
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Loic Nageleisen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: protobuf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+description: Deftly interact with Google Music (a.k.a Skyjam)
+email:
+- loic.nageleisen@gmail.com
+executables:
+- skyjam
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- bin/skyjam
+- lib/skyjam.rb
+- lib/skyjam/client.rb
+- lib/skyjam/library.rb
+- lib/skyjam/music_manager.pb.rb
+- lib/skyjam/music_manager.rb
+- lib/skyjam/music_manager/auth_request.pb.rb
+- lib/skyjam/music_manager/export_tracks_request.pb.rb
+- lib/skyjam/music_manager/export_tracks_response.pb.rb
+- lib/skyjam/music_manager/response.pb.rb
+- lib/skyjam/track.rb
+- lib/skyjam/version.rb
+homepage: https://github.com/lloeki/ruby-skyjam
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Google Music API client
+test_files: []