Question 1

How do I install macadam on MacOS Mojave?

Accepted Answer

After installing Node.js and Blackmagic Desktop Video software, run xcode-select --install and install the macOS SDK headers package as specified in the README to handle native addon compilation.

Question 2

Macadam vs using the Blackmagic SDK directly?

Accepted Answer

Macadam provides a higher-level, promise-based JavaScript API that abstracts the low-level DeckLink SDK, making it easier for Node.js developers but with less direct control and potential performance overhead compared to C++ integrations.

Question 3

How to capture video with audio using macadam?

Accepted Answer

Use the capture method with parameters like channels, sampleRate, and sampleType set, as shown in the README example, to asynchronously retrieve both video frames and audio packets in a single frame object.

Question 4

Does macadam support external keying for live graphics?

Accepted Answer

Yes, on devices that support it, you can enable external keying by setting isExternal to true in playback options, with key levels adjustable via setLevel or ramp methods for smooth transitions.

Question 5

How to handle timecode drop frame formats in macadam?

Accepted Answer

Timecode strings must use colons for non-drop frame (e.g., HH:MM:SS:FF) and semicolons for drop frame (e.g., HH:MM:SS;FF), as detailed in the timecode section, to ensure proper insertion and retrieval on supported hardware.

Macadam

What is Macadam?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions