This add-on is operated by Danzig Media

Simple Video Recording For Web Apps


Last Updated: 26 September 2014

The CameraTag add-on is currently in beta.

Table of Contents

CameraTag is an add-on service that allows your you to easily add webcam video recording to your web application. All you have to do is embed our recorder (camera) and we’ll handle all the video streaming (in and out), thumbnail generation and file transcoding. We’ll even host the resulting files for you on our servers!

Cameratag is a JavaScript Library and REST API that will play nicely with any back-end platform (Rails, PHP, Node etc.) and work alongside existing JS Frameworks (jQiery, Prototype, Backbone, Ember, Angular etc.). Creating a camera and adding it to your site whould take no longer than a few minutes.

Provisioning the Add-On

cameratag can be attached to a Heroku application via the CLI:

A list of all plans available can be found here.

$ heroku addons:add cameratag
-----> Adding cameratag to sharp-mountain-4005... done, v18 (free)

Getting started

The first thing you need to do in order to use CameraTag is create a camera (shocking!). You do this using the CameraTag Admin Panel which can be accessed through the heroku CLI:

$ heroku addons:open cameratag
Opening cameratag for sharp-mountain-4005…

or by visiting the Heroku apps web interface and selecting the application in question. Select cameratag from the Add-ons menu.

The first time you open the Admin Panel it will prompt you to create a new camera. Complete the following fields in the new camera form then click the “create” button

More advanced configuration options will be available from the camera’s settings tab after it has been created

  • Recording Format: Choose the video resolution you wish your camera to record
  • Name: Give your camera a name (no spaces or special characters)
  • Authorized Host: Tell us the domain of the website in which your camera will be embeded
  • Max Video Length: The maximum permissible recording length in seconds (max 300)

Once you have created your camera adding it to your site is as simple as adding 2 lines of code to your site.

First, add the cameratag.js file to the header of your html

<script src="//" type="text/javascript"></script>

Second, add the <camera> tag to you HTML wherever you would like the recorder to appear

<camera id="MyCamera1" data-uuid="[INSERT_YOUR_CAMERA_UUID]"></camera>

That’s it! You should be up and running. You should now be able to start recording videos and see them show up in the videos section of your camera’s page in the Admin Panel.

Check out our docs for more information on how to: * Retrieve the video & thumbnail URLs, * Configure recording setting * Style and customize the recorder * Control the recorder with JS

Upgrading and downgrading

Use the heroku addons:upgrade command to migrate to a new plan.

$ heroku addons:upgrade cameratag:newplan
-----> Upgrading cameratag:newplan to sharp-mountain-4005... done, v18 ($49/mo)
       Your plan has been updated to: cameratag:newplan

Removing CameraTag

cameratag can be removed via the CLI.

This will destroy all associated data and cannot be undone!

$ heroku addons:remove cameratag
-----> Removing cameratag from sharp-mountain-4005... done, v20 (free)


All cameratag support and runtime issues should be submitted via the Contact Form or by emailing us at help at cameratag dot com