Difference between revisions of "BindSight"

From Hack Manhattan Wiki
Jump to: navigation, search
Line 14: Line 14:
* update README to point to this wiki
* update README to point to this wiki
* flesh out this wiki to describe feature set
==== SnapSource Stage ====
==== SnapSource Stage ====

Revision as of 15:40, 4 August 2019

Github icon.jpg Github Repository | Bricodash screenshot.png A Bricodash Sub-Project | Beads Land-Trujillo.jpg A Beadsland Creation

Concurrent frame-scrubbing multiplexing webcam gateway daemon.

Devoted service to stream doorcam and spacecam to Bricodash and public gateway, respectively, while tracking activity and performance of these and other webcams at the space. Will be more efficient and reliable than spawning PHP and Python processes on an as-they-come basis.

Written in Elixir, will be taking advantage of various new features of the language, building on the strengths of Erlang/OTP, including Mint (web client), GenStage (backpressure event pipelines) and ultimately mix release (build-time deployment packaging).

Current project plan:


  • update README to point to this wiki
  • flesh out this wiki to describe feature set

SnapSource Stage

  • revert changes
  • ignore backpressure, just dispatch events from snapshot task loop
  • test grab a batch
  • catch dead cameras rather than erroring out repeatedly

Broadcast Stage

  • test grab a batch
  • test identical frames received when multiple clients

Bad Frames

  • consumer-producer to check for bad frames
  • consumer-producer to queue multiple events into single batch event (handle_demand)
  • retool bad frames checker (handle_events):
    • max_demand/min_demand: 2/1
    • task_async over each batch event
    • filter out :corrupt/:greytoss for now
    • unbatch result to dispatch as list of events (ignore backpressure)

Quality Tracking

  • rename Spigot to SlurpSpigot
  • consumer-producer to filter out :corrput/:greytoss messages
  • new SpewSpigot to supervise filter->client pipelines
  • move multiple clients receive identical frames test to SpewSpigot (filter, GenStage.Stream)
  • introduce :corrupt/:greytoss messages and unit test on SpewSpigot (filter, GenStage.Stream)
  • allow natural :corrupt/:greytoss to flow from bad frames checker
  • consumer to flush broadcast and track quality

Web Consumer

  • web consumer as filter-spigot Task
  • web consumer poolboy


  • implement stream as snapshot flipshow
  • ensure recovery when flipshow fails
  • reimplement stream to consume source stream
  • ensure recovery when source stream fails


  • provide for throwing timeouts
  • implement greytoss checking
  • configure to launch as daemon
  • bootstrap to obtain dependencies and compile cold
  • incorporate sous veil / swap out PHP touch points
  • incorporate upt chk / swap out Python CGI touch point


  • fleshout README to document project
  • investigate periodic multi-hit events: server severing connections prematurely? badly behaved client device?
  • investigate specific issue of pishop launch causing multi-hit failures on all other clients