RUST · N-API · WEBRTC

Stream into Telegram
group calls, from Node.js.

Thread-safe Rust bindings for libntgcalls — the WebRTC engine behind Telegram voice and video chats. Bring your MTProto client; this handles the media. Works on Node.js and Bun.

Quick Start API Reference GitHub

terminal

$ npm install @arnabxd/ntgcalls-napi
# prebuilt binaries · linux · macos · windows

WHY

Thread-safe callbacks

Background native WebRTC thread events become event-loop tasks via N-API ThreadsafeFunction — crash-free.

Promise-based API

Heavy operations delegated to a Tokio threadpool through safe one-shot synchronization channels.

Smart ID mapping

Accepts a number or a bigint for Telegram chat/user IDs interchangeably — no manual conversions.

RPATH isolation

Resolves libntgcalls relative to the addon directory — no LD_LIBRARY_PATH needed, on any platform.

Overview The architecture and core concepts behind the bindings.
Quick Start A complete, runnable example from session create to teardown.
Data Structures Every TypeScript interface the package exposes.
API Reference Global functions, the NtgCalls class, events, and methods.
Best Practices Event-loop hygiene, graceful state, and BigInt handling.

CREDITS

ntgcalls — the native C/C++ WebRTC library by the pytgcalls team that this package binds to.
TgMusicBot by Ashok Shau — referenced for the call lifecycle and signaling flow.

Edit on GitHub · MIT · v0.3.3

Stream into Telegramgroup calls, from Node.js.

Thread-safe callbacks

Promise-based API

Smart ID mapping

RPATH isolation

Stream into Telegram
group calls, from Node.js.