This repository has been archived by the owner. It is now read-only.
Do not attempt to adjust your television.
JavaScript CSS HTML
Switch branches/tags
Nothing to show
Clone or download
Latest commit 2b059f1 Aug 12, 2015

Meatspace Chat v2: Electric Boogaloo

Dependency Status devDependency Status


This is a rewrite of the old meatspace code and there are some notes:

  • This will not work with the old meatspace ios app, as the API has changed. Also, it does not work on ios browsers since they do not support using the camera directly.
  • There's a new ios app available on the app store.
  • This should work in Android within Firefox or Chrome.

Install ffmpeg


brew install ffmpeg --with-fdk-aac --with-ffplay --with-freetype --with-frei0r --with-libass --with-libvo-aacenc --with-libvorbis --with-libvpx --with-opencore-amr --with-openjpeg --with-opus --with-rtmpdump --with-schroedinger --with-speex --with-theora --with-tools

On Ubuntu

Everything else:

Install node and related items

npm install
cp local.json-dist local.json
npm start

Accessing the API

This is using the latest version of and will not work with the old version from the previous meatspace API.

To post:

Emit to 'message' - in JavaScript on the clientside it would be like this:

var socket = io();

socket.emit('message', {
    message: 'your chat message',
    media: ['data:image/jpeg;base64,<a base64 blob of the jpeg data>', 'data:image/jpeg;base64,<a base64 blob of the jpeg data>', ...],
    ip: '<ip address of user>',
    fingerprint: '<a unique fingerprint for the device or service>',
    videoType: 'webm'


  • media has to be an array of 10 JPEG data URIs. Ideally they are recorded 200 ms apart for consistency. Image snapshots must be 200x150 in dimension when sent to the server. If you build a mobile app, you can just scale down the view in the interface but please do not send any other sizes or it won't look good.

  • videoType defaults to 'webm' but you can request 'mp4' to have that sent instead. This is useful if you want to build an iOS client.

To listen to incoming messages:

socket.on('message', function (data) {

Contribution Guidelines

Read our Contributors' Guide for details.