Next Generation version of the RaceCapture App
Latest commit 1122cc1 Jul 21, 2018
Permalink
Failed to load latest commit information.
autosportlabs fix API parsing for sdLogCtrlCfg API (was still on obsolete autoLogge… Jul 21, 2018
build_tools setup enhancements WIP Nov 28, 2017
data/images Add new theme file for bubble arrow color Jul 1, 2016
defaults ensure defaults folder exists Mar 20, 2016
demo_screenshots shrink image Jul 13, 2017
dependencies update asl_f4_loader to show version Jun 16, 2018
garden_androidtabs hook up OBDII PID editor Mar 26, 2017
install update excludes for ios Jan 6, 2018
installfix_garden_graph prevent rendering invalid data. resolves #1530 Feb 11, 2018
installfix_garden_navigationdrawer fixed path to gradient backgrounds for navigation drawer Sep 29, 2015
java update copyright headers Oct 18, 2017
resource add preset for RCT MK2 Jul 13, 2018
sqlturk re-raise exception if migration fails Nov 14, 2016
test fix unit tests Jul 21, 2018
tools update copyright headers Oct 18, 2017
.gitignore update ignore file Jul 13, 2017
CHANGELOG.txt update changelog Jul 21, 2018
CONTRIBUTING.md BT config popup with validation, improved error popups, improved form… Jul 1, 2016
LICENSE Update LICENSE May 6, 2014
README.md update readme for raspberry pi notes, #2 Jan 5, 2018
Vagrantfile Add Ubuntu-based Vagrant config Oct 15, 2014
boundedlabel.kv update copyright headers Oct 18, 2017
boundedlabel.py update copyright headers Oct 18, 2017
build_debug_apk.sh update copyright headers Oct 18, 2017
build_release_apk.sh Merge branch 'r/1.11.2' into p/brent/presets Oct 18, 2017
buildozer.spec exclude demo_screenshots from buildozer. #1450 Nov 30, 2017
channelnamespinner.py update kivy requires to 1.10.0. resovles #1475 Oct 18, 2017
ds_runtests.py update copyright headers Oct 18, 2017
emu_phone.sh update copyright headers Oct 18, 2017
fieldlabel.py remove commented out code Jul 11, 2018
helplabel.py update kivy requires to 1.10.0. resovles #1475 Oct 18, 2017
iconbutton.kv Merge branch 'r/1.8.0' into p/brentpicasso/CAN_mapping Nov 17, 2016
iconbutton.py fix layout for phone pixel density Nov 23, 2017
launch_apk.sh update copyright headers Oct 18, 2017
launch_desktop.sh update copyright headers Oct 18, 2017
main.py bump version Jul 21, 2018
mainfonts.py update copyright headers Oct 18, 2017
mappedspinner.py Merge branch 'r/1.11.2' into r/1.12.0 Oct 18, 2017
racecapture.kv update kv file requires Oct 26, 2017
requirements.txt bump requirements.txt to 0.3.3 for asl_f4_loader Jul 6, 2018
runtests.py update copyright headers Oct 18, 2017
sampleratespinner.py update kivy requires to 1.10.0. resovles #1475 Oct 18, 2017
samplerateview.kv Merge branch 'r/1.11.2' into p/brent/presets Oct 18, 2017
samplerateview.py update kivy requires to 1.10.0. resovles #1475 Oct 18, 2017
settingsview.kv update kv file requires Oct 26, 2017
settingsview.py update kivy requires to 1.10.0. resovles #1475 Oct 18, 2017
spacer.py update copyright headers Oct 18, 2017
utils.py update copyright headers Oct 18, 2017
vagrant_provision.sh update copyright headers Oct 18, 2017
valuefield.py update copyright headers Oct 18, 2017

README.md

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 https://github.com/kivy/kivy/issues/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