Technology

Director: Charles Syperski

Department Phone: (630) 530-3978

Telescreen Installation Guide

Overview

This is a semi-technical tutorial that will walk the user through the process of installing Telescreen on Ubuntu Server 20.04.  Telescreen is an IP camera proxy application which allows you to view IP cameras remotely on traditional and mobile devices.  This installation requires two main components, Telescreen and User Central Manager or UCM.  Telescreen is the application that allows remote users to view IP cameras, where User Central Manager is a library and web interface that can be used to manage users for multiple web applications from a central location.  In this case it will only be used to manage users for Telescreen.    

Installation


In this tutorial we will be installing Telescreen and User Central Manager on Ubuntu Linux 20.04 (Server Edition).  Telescreen and User Central Manager will both be installed on a single machine in this tutorial.  Ubuntu server doesn't come with a graphical user interface by default, so everything will need to be typed by hand in the terminal.  It is recommended, but not required, that you install openssh-server and use a client like putty to access your server, this will allow you to easily copy and paste the commands in red below.  

  1. Install Ubuntu 20.04 Server - 64-bit on a server or virtual machine with at least 4GB of memory (8GB or higher recommended).  

    ** Do not use the Desktop version as the steps in this tutorial will not match  **

  2. Install the server and set a static IP during installation

  3. Run the installer

    sudo su -c "bash <(wget -qO- https://dupage88.net/tsinstall)" root

  4. Open a web browser and navigate to http://x.x.x.x/Telescreen and login with:

    Username: admin
    Password: password

Camera Setup 

After initial setup, you'll want to add a camera.  To do this, performthe following:

  1. Login as an administrator
  2. Go to Manage System
  3. Go to Camera Models
  4. Click Add Model
  5. Specify a Make and Model of the Camera (ie: Axis M3046)
  6. You'll need to specify resolutions you'd like to support based on bandwidth, if you are unsure specify 1920 x 1080 for all sizes.  
  7. In the URL template you'll need to specify the address to your cameras RTSP stream, for the Axis M3046, it would be something like:  

    rtsp://{username}:{password}@{ipaddress}:554/axis-media/media.amp?videocodec=h264&date=0&clock=0

    In this example {username}, {password}, and {ipaddress} are variables that will be used when you setup individual cameras, so leave them as is for now.  

Now that we have defined a camera model, let's setup a camera to view.  

  1. Click on Cameras
  2. Click Add Camera
  3. Give the camera a title, and select the model
  4. Set the camera's IP address and give it a building number.  
  5. Enter the username and password needed to view the camera
  6. Click Add

 

Other Information

Important URLS

User Management

After installation, PLEASE CHANGE THE ADMIN PASSWORD!  The default password for admin is as weak as they come, so please change it as soon as possible.  You can do this from within User Central Management in the Users Section.  Search for the user and click on the magnifying glass icon to modify the user and change their password.