Skip to main content

A video over TCP client

Project description



Node.js installation:

npm install fireeye

Python installation:

pip install FireEye

These libraries are developed in parallel, and designed to be used together. Please note: The Python side of this library is tested only with Python 3.


FireEye enables real-time bidirectional communication between a Node.js server, and a Python process. It is specifically designed to stream video between these two processes when running on separate devices.

Its main features are:


Connections are made using TCP sockets and can pass information from processes extremely quickly and reliably. FireEye operates using IPv4.

Easy to use

This library was designed to lower the barrier to entry as much as possible. As such, it has a built in wrapper to send images from process to process.

How to use — Node.js

The following example imports and creates the data socket in Node.js, and then sets up a listener event.

const FireEye = require('fireeye');

var socket = new FireEye();

socket.on('image', (data) => {
	/* your code here */

The example above can be used to receive entire images sent from Python.

FireEye can also be used to send arbitrary information across the TCP socket. Any JSON serializable object can be sent:

const FireEye = require('fireeye');

var socket = new FireEye();

var channel = 'channel_1';

socket.write(channel, 'Hello from Node.js!');

socket.on(channel, (data) => {
	/* your code here */

Any channel name can be used, except for image which is reserved for sending images from Python → Node.js

How to use — Python

The following is a simple example of how to use FireEye in Python:

from FireEye import FireEye
import cv2

socket = FireEye.FireEye()

cap = cv2.VideoCapture(0) #Camera Number Here

ret, frame =


Please Note: Creating a FireEye socket in Python is a blocking action and will not finish until the socket is opened.

As shown above, arbitrary data can be sent across FireEye. Here is an example in Python that matches the one above:

from FireEye import FireEye

socket = FireEye.FireEye()

channel = 'channel_1'

socket.write(channel, 'Hello from Python!')

response = socket.get(channel)

FireEye will automatically store the most recent piece of data received over a channel. This data is accessible via the get method. FireEye runs on a separate thread from the rest of your program and will therefore be constantly reading from the data socket.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for FireEye, version 0.5.0
Filename, size File type Python version Upload date Hashes
Filename, size FireEye-0.5.0-py3-none-any.whl (4.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size FireEye-0.5.0.tar.gz (3.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page