https://github.com/julusian/node-blackmagic-controller

A Node.js library for interfacing with the Blackmagic ATEM Micro Panel (possibly others in future)
https://github.com/julusian/node-blackmagic-controller

Last synced: 2 months ago
JSON representation

A Node.js library for interfacing with the Blackmagic ATEM Micro Panel (possibly others in future)

• Host: GitHub
• URL: https://github.com/julusian/node-blackmagic-controller
• Owner: Julusian
• License: mit
• Created: 2024-08-29T22:04:21.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-09-02T21:30:32.000Z (4 months ago)
• Last Synced: 2024-11-01T18:51:33.257Z (2 months ago)
• Language: TypeScript
• Size: 2.64 MB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# @blackmagic-controller

![Node CI](https://github.com/Julusian/node-blackmagic-controller/workflows/Node%20CI/badge.svg)

[![codecov](https://codecov.io/gh/Julusian/node-blackmagic-controller/branch/master/graph/badge.svg?token=Hl4QXGZJMF)](https://codecov.io/gh/Julusian/node-blackmagic-controller)

[@blackmagic-controller](https://www.npmjs.com/org/blackmagic-controller) is a collection of libraries for interfacing with the various models of the usb controllers made by [Blackmagic Design](https://www.blackmagicdesign.com/).

## Installing & Usage

Check one of the installable packages for installation and usage instructions:

-   [`@blackmagic-controller/node`](https://npm.im/@blackmagic-controller/node)

-   [`@blackmagic-controller/web`](https://npm.im/@blackmagic-controller/web) (Not yet ready for use)

### Have another hid target you wish to use?

The existing implementations are a light wrapper around the platform agnostic [`@blackmagic-controller/core`](https://npm.im/@blackmagic-controller/core). You can use your own HID implementation and device scanning/opening logic and reuse all the blackmagiccontroller bits.

## Demo

If you are using a Chromium v89+ based browser, you can try out the [webhid demo](https://julusian.github.io/node-blackmagic-controller/)

## Linux

On linux, the udev subsystem blocks access to the BlackmagicController without some special configuration.

Copy one of the following files into `/etc/udev/rules.d/` and reload the rules with `sudo udevadm control --reload-rules`

-   Use the [headless server](./packages/node/udev/50-blackmagic-controller-headless.rules) version when your software will be running as a system service, and is not related to a logged in user

-   Use the [desktop user](./packages/node/udev/50-blackmagic-controller-user.rules) version when your software is run by a user session on a distribution using systemd

Unplug and replug the device and it should be usable

## Contributing

The blackmagic-controller team enthusiastically welcomes contributions and project participation! There's a bunch of things you can do if you want to contribute! Please don't hesitate to jump in if you'd like to, or even ask us questions if something isn't clear.

Please refer to the [Changelog](CHANGELOG.md) for project history details, too.