Latest 0.1.2
License Apache2
Platforms osx 10.10
Dependencies ZXingObjC
Frameworks Cocoa, Foundation


SenbayKit-macOS is a development library for adding Senbay functions into your macOS application.



SenbayKit requires macOS 10.10 or later. This library supports both Swift and Objective-C. The sample code is written in Swift.


SenbayKit-macOS is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod 'SenbayKit-macOS'

How to use


  1. Setup Info.plist
    Please add following keys to Info.plist

    • NSCameraUsageDescription
  2. Setup capabilities
    Capabilities -> App SandBox -> Hardware -> Camera

Senbay Reader

  1. Import SenbayKit into your source code

    import SenbayKit_macOS;
  2. Add SenbayReaderDelegate into your NSViewController
    class ViewController: NSViewController, SenbayReaderDelegate {
    // some codes here
  3. Initialize and start SenbayReader
var reader = SenbayReader()
reader.delegate = self;
  1. Receive detected and decoded data via SenbayReaderDelegate

    func didDetectQRcode(_ qrcode: String)
    func didDecodeQRcode(_ senbayData: [String : Any])
    func didChangeCaptureArea(_ rect: CGRect) {
  2. (Option) Set the capture area

You can adjust the capture area of SenbayReader by setCaptureAreaWith(_ rect:CGRect) method on SenbayReader.

func setCaptureAreaWith(_ rect: CGRect)

Moreover, SenbayReader has adjustCaptureArea() method. Just by calling this method, SenbayReader automatically detect a QRcode on your target screen, and adjust the capture area depend on the QRcode size and position.

  1. (Option) Set configuration of SenbayReader

SenbayReaderConfig class manages the configuration of SenbayReader.

let CONFIG = SenbayReaderConfig{config in
    config.frequency = 30
    config.captureAreaX = 0
    config.captureAreaY = 0
    config.captureAreaWidth  = 200
    config.captureAreaHeight = 200
let reader = SenbayReader(config: CONFIG)
let reader = SenbayReader()
reader.config.frequency = 30

Author and Contributors

SenbayKit is authord by Yuuki Nishiyama. In addition, Takuro Yonezawa, Denzil Ferreira, Anind K. Dey, Jin Nakazawa are deeply contributing this project. Please see more detail information on our website.

Related Links


Please cite these papers in your publications if it helps your research:

author = {Nishiyama, Yuuki and Dey, Anind K. and Ferreira, Denzil and Yonezawa, Takuro and Nakazawa, Jin},
title = {Senbay: A Platform for Instantly Capturing, Integrating, and Restreaming of Synchronized Multiple Sensor-data Stream},
booktitle = {Proceedings of the 20th International Conference on Human-Computer Interaction with Mobile Devices and Services Adjunct},
series = {MobileHCI '18},
year = {2018},
location = {Barcelona, Spain},
publisher = {ACM},


SenbayKit is available under the Apache License, Version 2.0 license. See the LICENSE file for more info.

Latest podspec

    "name": "SenbayKit-macOS",
    "version": "0.1.2",
    "summary": "Senbay: A Platform for Instantly Capturing, Integrating, and Restreaming of Synchronized Multiple Sensor-data Streams",
    "description": "The spread of smartphones allows us to freely capture video and diverse hardware sensors' data (e.g., accel erometer, gyroscope). While recording such data is relatively simple, it is often challenging to share and restream this data to other people and applications. Such capability is very valuable for a range of applications such as a context-aware prototyping/developing platform, an integrated data recording and analysis tool, and a sensor-data based video editing system. To enable such complex operations, we propose Senbay, a platform for instant sensing, integrating, and restreaming multiple-sensor data streams. The platform embeds collected sensor data into a video frame using an animated two-dimensional barcode via real-time video processing. The video-embedded sensor data, dubbed Senbay Video, can be easily restreamed to other people and reused by data rich, context-aware applications.",
    "homepage": "",
    "license": {
        "type": "Apache2",
        "file": "LICENSE"
    "authors": {
        "Yuuki Nishiyama": "[email protected]"
    "source": {
        "git": "",
        "tag": "0.1.2"
    "platforms": {
        "osx": "10.10"
    "source_files": "SenbayKit-macOS/Classes/**/*",
    "frameworks": [
    "dependencies": {
        "ZXingObjC": []

Pin It on Pinterest

Share This