RaceCapture App

App for the RaceCapture series of motorsport telemetry systems.

Dependencies

See requirements.txt for full list of requirements

dev installation (OS X)

1. Install kivy 1.9.1 via pip

• Instructions: https://kivy.org/docs/installation/installation-osx.html

1. install virtualenv
2. create a virtual environment (perhaps in this directory): virtualenv _ve
3. activate the virtualenv: . _ve/bin/activate
4. install pip requirements: pip install -r requirements.txt (you may be required to upgrade your version of setuptools via the provided command)
5. install asl_f4_loader in dependencies folder: pip install asl_f4_loader-X.X.X.tar.gz
6. install pygame (http://www.pygame.org/download.shtml - use correct package for your OSX+Python version)

Simplified dev install (OS X)

1. Install kivy 1.9.1 via pip

• Instructions: https://kivy.org/docs/installation/installation-osx.html

1. install Kivy into Applications and run symlink script
2. install virtualenv
3. re-enable setup tools for Kivy virtualenv: sudo virtualenv /Applications/Kivy.app/Contents/Resources/venv/
4. install pip requirements: /Applications/Kivy.app/Contents/Resources/venv/bin/pip install -r requirements.txt
5. run app: kivy main.py

running (OS X)

/Applications/Kivy.app/Contents/Resources/script main.py

Building releases (all platforms)

1. Add a .sentry file with the app's platform-specific DSN for Sentry
2. Follow the platform-specific build instructions

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

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

• Email the developer mailing list: https://groups.google.com/forum/#!forum/autosportlabs-developers
• File an issue: https://github.com/autosportlabs/RaceCapture_App/issues