README.md

ODK XLSForm Offline

ODK XLSForm Offline is a Windows and macOS application for converting an XLSForm into an XForm that is compliant with the ODK XForms spec. Once converted, the application also validates that the XForm will run perfectly with all ODK tools.

ODK XLSForm Offline is part of Open Data Kit (ODK), a free and open-source set of tools which help organizations author, field, and manage mobile data collection solutions. Learn more about the Open Data Kit project and its history here and read about example ODK deployments here.

• ODK website: https://opendatakit.org
• ODK forum: https://forum.opendatakit.org
• ODK developer Slack chat: http://slack.opendatakit.org
• ODK developer Slack archive: http://opendatakit.slackarchive.io
• ODK developer wiki: https://github.com/opendatakit/opendatakit/wiki

Prerequisites

1. Install Python 2.7
   • If you are on Windows, you must install the 32 bit version.
2. Install Python packages: pip install pyinstaller wxpython pyxform
3. Install packaging utilities
   • macOS: brew install unix2dos
   • Windows: upx

Run

To run the app, python src/main.py

Package

The easiest way to package is to use a macOS machine running a Windows 10 virtual machine. Share the xlsform-offline folder on the Mac with Windows, then mount that folder as the Z drive with pushd "\\vmware-host\Shared Folders\xlsform-offline\".

1. In the macOS machine, run ./make-mac.sh to build the Mac binary.
2. In the Windows virtual machine, run make-win.bat to build the Windows binary.
3. Finally, in the macOS machine, run ./make-dist.sh to zip up the Mac and Windows binaries.