https://github.com/rekram1-node/blinkgo
Simple SDK for interacting with blink cameras, mainly: authentication, listing devices/networks/clips, and downloading clips from local storage
https://github.com/rekram1-node/blinkgo
blink blinkpy camera golang-library home-automation sdk sdk-go security-camera
Last synced: about 1 year ago
JSON representation
Simple SDK for interacting with blink cameras, mainly: authentication, listing devices/networks/clips, and downloading clips from local storage
- Host: GitHub
- URL: https://github.com/rekram1-node/blinkgo
- Owner: rekram1-node
- License: mit
- Created: 2023-01-01T06:38:07.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-01-18T17:53:52.000Z (over 3 years ago)
- Last Synced: 2024-06-20T22:35:49.879Z (almost 2 years ago)
- Topics: blink, blinkpy, camera, golang-library, home-automation, sdk, sdk-go, security-camera
- Language: Go
- Homepage:
- Size: 73.2 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# blinkgo
[](https://goreportcard.com/report/github.com/rekram1-node/blinkgo) [](https://github.com/rekram1-node/blinkgo/blob/main/LICENSE) 
Simple library for interacting with blink cameras, mainly: authentication, listing devices/networks/clips, and downloading clips from local storage
This library was made for my purposes but if you would like to see more features open an issue and I will get to it
Credit to MattTW, who's findings: [BlinkMonitorProtocol](https://github.com/MattTW/BlinkMonitorProtocol) I used to create this implementation
## Features
* authentication
* read networks, cameras, sync modules
* list videos
* download videos
## Getting Started
### Prerequisites
- [Go](https://go.dev/)
### Getting blinkgo
With [Go module](https://github.com/golang/go/wiki/Modules) support, simply add the following import
```go
import "github.com/rekram1-node/blinkgo/blink"
```
to your code, and then `go [build|run|test]` will automatically fetch the necessary dependencies.
Otherwise, run the following to install the `blinkgo` library
```shell
$ go get -u github.com/rekram1-node/blinkgo/blink
```
## Documentation
Read the [documentation](https://github.com/rekram1-node/blinkgo/blob/main/docs/docs.md) for usage instructions
## Authentication
#### Simple login and 2FA verify pin
```go
package main
import (
"fmt"
"log"
"github.com/rekram1-node/blinkgo/blink"
)
func main() {
email := "example@example.com"
password := "PLEASE_DON'T_PLAINTEXT_REAL_PASSWORDS"
// returns account object with: email, password, uuid
// this is required for login and once authenticated, used
// for any blink operations
account := blink.NewAccount(user, pass)
loginResp, err := account.Login()
if err != nil {
log.Fatal(err)
}
// if blink wants a 2FA verification you must use the
// verify pin operation
// 2FA is not always required but it is typically
// required first time on new device
if loginResp.Account.AccountVerificationRequired {
fmt.Print("Enter Pin: ")
var pin string
fmt.Scanln(&pin)
// this returns a verify pin response that you can use
// however, it is unneccessary for this example
if _, err := account.VerifyPin(pin); err != nil {
log.Fatal(err)
}
}
}
```
## Local-Storage
I did not discover this myself, this is from [blinkpy](https://github.com/fronzbot/blinkpy)
The steps for pulling videos from local storage
1. Query sync module for information regarding stored clips
2. Upload the clips to the cloud
3. Download the clips from a cloud URL
Beware the upload/download sequence, there must be a waiting period between the two as the operation is not instantenous
## Issues
If you have an issue: report it on the [issue tracker](https://github.com/rekram1-node/blinkgo/issues)