nolanbrown / dropcam Goto Github PK

View Code? Open in Web Editor NEW

41.0 10.0 11.0 176 KB

RubyGem for accessing Dropcam account and cameras

License: MIT License

Ruby 100.00%

dropcam's Introduction

Dropcam

RubyGem to access Dropcam account and Camera including direct live stream access

Installation

Add this line to your application's Gemfile:

gem 'dropcam'

And then execute:

$ bundle

Or install it yourself as:

$ gem install dropcam

Usage

require 'dropcam'

dropcam = Dropcam::Dropcam.new("<USERNAME>","<PASSWORD>")
camera = dropcam.cameras.first

# returns jpg image data of the latest frame captured
screenshot = camera.screenshot.current

# write data to disk
File.open("#{camera.title}.jpg", 'w') {|f| f.write(screenshot) }

# access and modify settings
# this disables the watermark on your camera stream
settings = camera.settings
settings["watermark.enabled"].set(false)

Live Stream

Streaming isn't directly integrated currently and it's up to you to find a player. Some of the players available:

VLC (RTSP/RTMP)
RTMPDump (RTMP)
openRTSP (RTSP)

The easiest way to record the live camera stream is with RTMPDump. Install via homebrew:

`$ brew install rtmpdump`

To save a live stream:

require 'dropcam'
dropcam = Dropcam::Dropcam.new("<USERNAME>","<PASSWORD>")
camera = dropcam.cameras.first

# record the live stream for 30 seconds
camera.stream.save_live("#{camera.title}.flv", 30)

# to get access information to use a third party application
# RTMP/Flash Streaming
camera.stream.rtmp_details

# RTSP Streaming
camera.stream.rtsp_details

Currently stream resolution is limited to 400x240.

NOTES:

The Dropcam API is unofficial and unreleased. This code can break at anytime as Dropcam changes/updates their service.

This gem has only been tested on Mac OS 10.8 running Ruby 1.9.3

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

dropcam's People

Contributors

Stargazers

Watchers

Forkers

dturton masnick fusion94 stevenhaddox radekw devandanger cpayne4471 drsharp justinledwards jacksnow00 w-m-d

dropcam's Issues

Does this project still work post Nest.com move?

Is this project still working for anyone? Since the move to nest.com, all I get is
Dropcam::CameraNotFoundError: Camera Not Found

Camera Not Found (Dropcam::CameraNotFoundError)

Few days ago I noticed the library stopped working and fails with the following error on login.

irb(main):001:0> require 'dropcam'
=> true
irb(main):002:0> dropcam = Dropcam::Dropcam.new("", "")
Dropcam::CameraNotFoundError: Camera Not Found
    from /Library/Ruby/Gems/2.0.0/gems/dropcam-0.0.4/lib/dropcam/base.rb:108:in `get'
    from /Library/Ruby/Gems/2.0.0/gems/dropcam-0.0.4/lib/dropcam/session.rb:37:in `_session_token'
    from /Library/Ruby/Gems/2.0.0/gems/dropcam-0.0.4/lib/dropcam/session.rb:26:in `authenticate'
    from /Library/Ruby/Gems/2.0.0/gems/dropcam-0.0.4/lib/dropcam.rb:11:in `initialize'
    from (irb):2:in `new'
    from (irb):2
    from /usr/bin/irb:12:in `<main>'

RTSP Streaming

Is anyone having success streaming RTSP?

I have tried streaming a publicly available camera to my VLC player:

rtsp://user:[email protected]:554/be6db485223a41ee8c25ba468c056f8e

Streaming to Browser

Has anyone come up with good way to stream the cam to the browser?

I am thinking about pursuing this kind of an approach (https://github.com/ghostbar/RTSP-Streaming.js) but maybe someone has a better solution.

Maintained?

@nolanbrown if you don't care to maintain this I'm more than willing to take it over.

thoughts?

NameError: uninitialized constant Dropcam::Base::OpenSSL

Wanted to get started using this to be able to turn my dropcam ON / OFF at certain times of the day.

When I go through the settings example in irb I get the following error after I run

Dropcam::Dropcam.new("USERNAME","PASSWORD")

NameError: uninitialized constant Dropcam::Base::OpenSSL

Is there another required gem that I am missing?

Title changed to name?

Looks like the API may have changed, description and title are both empty.

Is this project still valid?

Nest has changed things a lot. I wonder are these APIs used in this project still valid?

camera.settings["watermark.enabled"].set(false) not working

# Disable watermark
settings = camera.settings
settings["watermark.enabled"].set(false)

The above, as written in the documentation, seems to not actually be changing the watermark to a disabled status and I'm still getting it on snapshots. I'm wondering if Dropcam changed the value of the parameter name or has disabled removing it?