/RaceCapture_App

Next Generation version of the RaceCapture App

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

RaceCapture App

RaceCapture is the companion app for the RaceCapture family of motorsport telemetry systems.

It includes:

  • A powerful, configurable dashboard;
  • Full configuration for the RaceCapture hardware;
  • Built-in analysis features;
  • The ability to live-stream to http://podium.live.

Multi Platform Support

We actively support 6 platforms, including the Raspberry Pi.

Latest releases:

Video demos

Click the following for a tour of the RaceCapture App:

IMAGE ALT TEXT

IMAGE ALT TEXT

IMAGE ALT TEXT

IMAGE ALT TEXT

IMAGE ALT TEXT

CAN bus mapping presets alt text

Analog sensor channel configuration alt text

Track Map Library alt text

Lua Scripting Editor alt text

dev installation (OS X)

  1. Install latest of python 2.x
  2. Confirm you have the latest version of homebrew, setuptools and pip installed
  3. Install kivy 1.10.0
  1. Activate virtual environment

  • cd /Applications/Kivy.app/Contents/Resources/venv/bin && source activate

  1. Navigate to the RaceCapture_App source directory
  2. Install dependencies: pip install -r requirements.txt
  3. Run the RaceCapture app: python main.py

Preparing to build installers (OSX)

  1. Make sure all dependencies are installed inside Kivy's venv
  2. cd /Applications/Kivy.app/Contents/Resources/venv/bin && source activate
  3. cd /path/to/RaceCapture_App && pip install -r requirements.txt
  4. If we're using a custom build of Kivy, we need to fix the paths for some libraries, run the install/osx/fix-osx-paths.sh script.

Creating installer for current version (OSX)

  1. cd install/osx
  2. ./build-osx.sh

The script will create the .App file and .dmg for distribution.

installation (Win7/8/10)

  1. Install x86 2.7.x Python and kivy via instuctions https://kivy.org/docs/installation/installation-windows.html
  2. Navigate to the RaceCapture source directory
  3. Install RaceCapture requirements: pip install -r requirements.txt

running (Win7/8/10)

  1. Navigate to the RaceCapture source directory
  2. Launch RaceCapture python main.py

IDE installation (Eclipse on Win7, but probably applies to Eclipse on any platform)

  1. Do the "installation" instructions above
  2. Download [Eclipse] (https://www.eclipse.org/downloads/)
  3. Install [PyDev for Eclipse] (http://pydev.org/manual_101_install.html) and use auto-config
  4. In Window..Preferences..PyDev..Interpreter..Python Interpreter..Environment, add a variable "PATH" with value c:\kivy;c:\kivy\Python;c:\kivy\gstreamer\bin;c:\kivy\MinGW\bin;%PATH%
  5. In Window..Preferences..PyDev..Interpreter..Python Interpreter..Forced Builtins, add "kivy" to the list
  6. Make a new project in Eclipse, select "PyDev project" and specify the folder with Racecapture in it
  7. Right-click the project...Properties...pyDev-PYTHONPATH...External Libraries - Add source folder, add my_kivy_install_folder\kivy
  8. Run the project

Create installer (Win7/8/10)

  1. Prepare dev installation (above)
  2. Install [nullsoft scriptable install system] (http://nsis.sourceforge.net/Download) stable version (currently 2.46)
  3. Navigate command line to install subfolder of RaceCapture app directory
  4. build_win_release.bat ..

dev installation (Linux - Ubuntu)

  1. Install kivy 1.9.1 via pip
  2. install [virtualenv]: sudo pip install virtualenv
  3. create a virtual environment (perhaps in this directory): virtualenv _ve
  4. activate the virtualenv: . _ve/bin/activate
  5. install pip requirements: sudo pip install -r requirements.txt (you may be required to upgrade your version of setuptools via the provided command)
  6. install asl_f4_loader in dependencies folder: pip install asl_f4_loader-X.X.X.tar.gz

running (Linux - Ubuntu)

python main.py

dev installation (Raspberry Pi)

  1. If installing on Raspberry Stretch you need Kivy Master (1.10.1) to work around window provider issue (see kivy/kivy#5360)
  2. Cython 0.23 required

Buildozer android APK build/install (Linux only)

  1. install buildozer from https://github.com/kivy/buildozer
  2. from the root RaceCapture app directory, run ./build_apk.sh . buildozer will download files as necessary and build the apk
  3. if buildozer fails with a cython error, install cython from your package manager
  4. if buildozer fails with an Android SDK error, enter the ~/.buildozer directoy and run android update sdk -u from the android tools directory.

Launch android apk

  1. Ensure your android device is in developer mode and plug it in via usb
  2. install / launch the app using ./launch_apk.sh
  3. Console / debug output will appear on screen as app is downloaded, installed and run

Getting help