Skip to content
Webrtc-based video platform. Client side is written in AngularJS, and the server is written in Python, and running on Google AppEngine.
Python JavaScript HTML CSS Shell
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bower_components/grunt-contrib-uglify Updated uglify to more recent version May 27, 2015
build_support renamed vidsetup to build_config Jul 9, 2015
client Updated to a newer version of the adapter.js shim. This fixes some is… Dec 29, 2016
jwt Initial steps toward getting Json Web Tokens (JWT) working for authen… May 13, 2015
node_modules Updated some node/sass/compass files Dec 29, 2016
request_handler_custom Moved http error capture and reporting into http interceptor. May 29, 2015
test Adding initial apprtc files to git May 29, 2014
test_video_src Removed dead code May 20, 2015
turn-prober Adding initial apprtc files to git May 29, 2014
venv Added venv Jul 13, 2019
video_src Removed the chatsurfing turn server IP address to prevent accidental … Nov 7, 2015
.gitignore Stopped tracking files in the client/dist directory May 27, 2015
LICENSE.md Removed reference to lexavideo.com, which does not yet (an may not) e… Nov 7, 2015
README-TURN-SERVER.txt Removed "secret key" values (yes, the git history will show the previ… Nov 7, 2015
README.md Update README.md Aug 13, 2019
app_template.yaml Wrote cron jobs for clearing expired session, user, and client models. May 22, 2015
build_app.py renamed vidsetup to build_config Jul 9, 2015
build_config.py Updated to a newer version of the adapter.js shim. This fixes some is… Dec 29, 2016
cron.yaml Wrote cron jobs for clearing expired session, user, and client models. May 22, 2015
main.py renamed vidsetup to build_config Jul 9, 2015
queue.yaml Wrote cron jobs for clearing expired session, user, and client models. May 22, 2015
run_app.py Removed reference to lexavideo.com, which does not yet (an may not) e… Nov 7, 2015
setup.cfg Appear to have gotten py.test basically working. Sep 22, 2014
upload_app.py Removed reference to lexavideo.com, which does not yet (an may not) e… Nov 7, 2015
video-app.wpr New project settings for pycharm Sep 21, 2014
video-app.wpu

README.md

Introduction

NOTE: As of Oct 31 2017 google has depreciated the Channel API that this application relied on, and therefore many functions are currently broken.

Overview

LexaVideo provides the source code for running a fully responsive web-app that features real-time browser-based video conferencing and text chat.

This software relies on WebRTC for the video functionality, and is built using AngularJS and Python. This software runs on Google AppEngine.

Demo

LexaVideo was originally developed for ChatSurfing.com. Check out ChatSurfing.com for an active demo of this source code in action Due to removal of the Channel API this web application does not currently work correctly.

Quick Start

Before running LexaVideo

LexaVideo requires that Python and the Google AppEngine are installed on your local computer. This software was tested with AppEngine release 1.9.20, and Python 2.7

LexaVideo uses yeoman, grunt, and bower as part of our build system. Make sure that you have node.js installed, and are able to execute grunt.

How to run LexaVideo

LexaVideo has been tested on OSX and Linux. Use a unix shell to execute the following commands:

  1. In the first unix shell, cd into the client directory, and then run 'grunt serve'. If you forget to do this, then you may not be able to load css files and other strange behaviour may happen.
  2. In a second unix shell, from the project base directory, run './run_app.py .' (don't forget the '.' at the end).
  3. In your browser, open localhost:8080

Code Structure

Server-side Code

The server-side (python) code is contained in the 'video_src' directory

Client-side Code

The client-side code is located in the 'client/app' directory. Within this directory, you will find the following directories of interest:

  1. bower_components: Contains AngularJS, Bootstrap, and many other open-source projects that we rely on.
  2. images: Logos, icons, etc.
  3. lx-templates: Our custom html templates.
  4. scripts: The directory that contains the client-side javascript code. This is broken into sub-directories that follow AngularJS terminology.
  5. sounds: This contains mp3 sounds that are not currently used.
  6. styles: The SASS (CSS) styles that define how our website looks.

Here you will also find index.html, which is the parent html file that imports all javascript, css, and other html.

Releasing code to a production server

General information about uploading

While it is possible to directly upload code that runs directly from the 'client/app' directory (where we have our client-side 'source' files), for performance reasons this is not advisable. Instead one should ensure that files that will be used in production are combined, minimized, and compressed. This is where grunt is very helpful, and where we have provided scripts to help ensure that optimized files are updated.

Building code before uploading

From the project home, you can execute the file 'build_app.py', which will modify the app.yaml to use files in the 'client/dist' directory instead of the 'client/app' directory. Note: this script requires that DEBUG_BUILD=False (don't worry if you forget, you will get a warning), which can be modified in build_config.py. Warning: if you change DEBUG_BUILD to be False, then next time you are editing and testing 'client/app' files, the files will not be used because you will be accessing files in the 'client/dist' directory instead of the 'client/app' directory. After uploading code to the server, set DEBUG_BUILD=True. Do not manually edit files in the 'client/dist' directory, as this is over-written by our build scripts.

Uploading code to the server

From the project home, run 'upload_app.py', which is a wrapper for the standard appcfg.py update command. Using this script will catch and prevent many common errors when uploading code.

You can’t perform that action at this time.