Main screen

Main screen

The Upload report symbol varies depending on the selected connection type.

Upload symbols

Start window

The Start window highlights the participants that are due for tick off.

It is a sliding time window, which moves forward as time passes on. Participants are entering the window, being ticked off (or DNS), and then, leaving the window.

Manual tick off

Tap on a participant to change his/her status:

Late start denotes a participant that was initially ticked off as DNS but has later shown up.

Search

Search for participants by entering free text. Tap the search symbol in the main screen to customise the search options:

Search settings dialogue

Automated tick off

When the participant inserts the card into the SPORTident station, the card number is checked and the participant is automatically ticked off.

If the inserted card does not match any participant, a list of candidates is displayed. Candidates are:

Select one of the candidates to change status to Started (or, Late start) with a new card number.

Other options:

Copy card saves the card number, which can then be pasted when editing a participant.

Manually create a New participant with this card number. This feature has to be enabled in the Settings.

Card not found dialogue

Edit participant

Change the card number:

A comment can also be entered (free text).

Edit participant dialogue

Start status reports

There are two types of start status reports:

The start status reports can be customised as described in the Settings section below.

Note that OFeed does not use YAML/text reports. Data exchange between O Checklist and the server is based on a proprietary format.

The symbol shown in the top of the main window varies by the selected function:

Upload complete YAML report to server using HTTP POST or FTP.

Upload incremental YAML report to server using HTTP POST or FTP.

Email text and/or YAML reports.

The screenshots below show:

Start status (main screen) Start status (inlined email report) Start status (YAML report)

Settings

Time adjustment — The entered value is added to the current time:

Start window — The duration of the Start window. Suggested settings:

Symbols:

Give a sound signal (a short double beep) when the start window moves forward.

Participants who have not been ticked off as started will automatically get status DNS when leaving the start window.

SPORTident station

Give a sound signal (a few happy beeps) when a participant is automatically ticked off OK.

Give an audible error signal (a buzzing sound) when a participant has an unknown card or is outside the start window.

More features

Confirm manual status change (by tapping on a participant) when the new status becomes DNS (red), Lat start (orange), or, Reset (initial state, uncoloured).

Add new participants manually.

Name order, how first and last names are displayed, for example Olivia Johnson or Johnson, Olivia or Olivia JOHNSON or JOHNSON, Olivia.

Server connection

The YAML formatted start status report can be uploaded to a server using HTTP POST or FTP. The YAML and/or text reports can also be emailed. OFeed uses a proprietary format to download participants and to report start status.

Select how to connect to the server.

Connect to OFeed cloud data hub.

Upload YAML report to server using HTTP POST.

Upload YAML report to server using FTP.

Email start status reports (YAML and/or text).

All reporting is disabled.

Settings dialogue

Server connection — OFeed

Use the camera of your device to scan the QR code provided by OFeed, or tap the Scan button in the settings menu. This will connect O Checklist to the OFeed server and start the download of classes and participants.

Alternatively, enter the login details manually:

Advanced settings:

OFeed settings dialogue

Server connection — POST

Manually upload to server by tapping the upload symbol in the main window.

Automatic upload, every n:th minute.

Customise the contents of the start status reports.

Incremental upload. Only participants that have changed since the previous upload are included in the YAML report.

Advanced settings:

Generate a checksum (a hash value) for the YAML start status report. The checksum is added as an HTTP header Content-Digest which can be used by the server to verify the integrity of the YAML file (the report). Tap Settings button to select algorithm and encoding.

Compress the HTTP request body. Requires that the server can handle gzip compression.

HTTP timeouts – Adjust the timeouts of the HTTP protocol.

HTTP POST settings dialogue HTTP POST checksum dialogue HTTP timeout  dialogue

Server connection — FTP

Manually upload to host by tapping the upload symbol in the main window.

Automatic upload, every n:th minute.

Customise the contents of the start status reports.

Incremental upload. Only participants that have changed since the previous upload are included in the YAML report.

FTP settings dialogue

Email reports

The start status reports (YAML and/or text) can be emailed by tapping the mail symbol in the main window.

Email settings dialogue

Customise start status reports

This section is applicable for POST/FTP/Email, only. OFeed uses a proprietary format to submit/retrieve data.

There are two types of start status reports:

Select whether to include the following data in the start status reports:

Select which start status reports that are to be sent by email:

Status report customisation dialogue

XML/CSV start list

O Checklist can import a start list either in XML or CSV format. Note: For OFeed, see next section.

Workflow overview

Import start list workflow

Prepare start list

Create the start list, either in XML format, or, in CSV format (Comma-Separated Values).

  1. XML — Use event admin software that supports IOF Data Standard 3.0 (International Orienteering Federation).
  2. CSV — Use one of the following options:
    • Let an AI chatbot (ChatGPT, Gemini, Copilot, and others) generate the CSV file. For example, prepare the start list in Microsoft Excel, then issue a prompt such as With the uploaded Excel file as input, make a CSV file with the following fields: Name, Organisation, Class, BibNumber, StartTime, ControlCardNumber, StartName. It may take a few iterations to get a correct CSV file that can be imported.
    • CSV Tool, which is a web based utility.
    • Download and use export_csv.xlsm, which is a Microsoft Excel based utility.
    • Edit the CSV template manually using a text editor (for example, Windows Notepad, macOS TextEdit, or, Notepad++).

Transfer start list to phone/tablet

Transfer the file to be imported (the start list) to the device (phone/tablet). This can be done in several ways, for example, by emailing or downloading the file.

Import start list

The start list can be imported from within O Checklist, from your email, or, through a file manager.

During the import:

How to find the import file

If the file has been downloaded, it is usually stored in Android's Downloads folder. Use a file manager (for example, Files by Google, Total Commander) to locate it.

If the file is stored in a cloud service (for example, Google Drive, Dropbox, Onedrive), it may need to be exported to Android's file system.

Troubleshooting import

When tapping on an XML/CSV file, Android uses the file extension to determine that the file is handled by O Checklist, and then sends the file to O Checklist. If there are several apps that can handle this filetype, Android will ask which app to use.

If another app (not O Checklist) starts when you tap on the XML/CSV file, then that app has been set as the standard app for this filetype. It could for example be the MS Excel app, an office app, or any similar app. Go to Android's settings, select Apps, and tap into the app that starts instead of O Checklist. Now clear this standard setting.

Note – This is a description of Android's handling of filetypes (MIME types), which is used when opening a start list from an email app or a file manager. It is not applicable when importing from within O Checklist (or, from a file manager if Open with is used), because the picked file is then directly sent to O Checklist.

Supported file formats

XML, in accordance with IOF Data Standard 3.0. Does not support multiple contests in one XML file (multiday events). Filename must end with extension .xml (lower case).

CSV, with the following comma-separated fields: Name*, Organisation*, Class*, BibNumber, StartTime, ControlCardNumber, StartName. Fields containing commas must be enclosed with quotation marks, for example, "Last name, first name". Blank lines are ignored, comment lines start with // (double slash). CSV file should be in UTF-8 format (good for åäöæøüáóñéèùšů…). Filename must end with extension .csv (lower case).

OFeed start list

OFeed is an is an open source cloud data hub for orienteering events. It handles events and their classes and participants. O Checklist can connect to OFeed and download the start list of an event, and then receive new participants (on-the-day entries) as well as updated participants (typically with changed card numbers) from OFeed. O Checklist in return reports status changes of the participants (started/DNS), changed card numbers and new entries to OFeed.

Workflow overview

OFeed workflow

Setup connection

Select Delete all in the main menu to delete any previously imported start list.

Automatic setup

This will connect O Checklist to the OFeed server and start the download of classes and participants.

Manual setup

Download participants

OFeed download participants dialogues

Updates

Updates between OFeed and O Checklist are all automatic. The OFeed symbol in the main window turns green when an update takes place, red if there was an error. Tap on the symbol to view the log.

Symbol in main window.

A changed participant (for example, new start status, changed card, new comment, new participant) is submitted to OFeed (almost) directly. A short delay (configurable, seconds) gives the user some extra time to finalise the input before it is sent to OFeed.

Updates from OFeed are requested by O Checklist regularly (configurable, minutes)

Free start

Some classes have free start time, which means that runners of these classes do not have a fixed start time but can choose when to start. A runner’s start time is then recorded when he/she punches the SPORTident station at the starting line.

This section is being revised.

SPORTident station

Configuration

The SPORTident station can be configured in Readout, Check or Clear mode. Readout mode gives the basic functionality whereas Check mode provides a quick and easy way to admit participants to the first start box; One punch and he/she may enter.

Use SPORTident software Config+ (Windows) to configure the SPORTident station. Auto send must be enabled for Check and Clear modes, and disabled for Readout mode. Setting Legacy protocol must be disabled for all modes.

SPORTident Config+

SRR USB Dongle

A SPORTident SRR USB Dongle (SRR, short range radio) can be connected to O Checklist. It can be used together with a BSF8-SRR-DB SPORTident station configured in Check mode and mounted on a fixed stand. Such a setup allows the "tick off handler" to move around (somewhat) more freely.

Suggested placement

Place a Clear station somewhere in the warm-up area (either centrally or at the entrance) where each participant clears his/her card.

At the entrance to the first start box, use a station configured in Check mode connected to O Checklist. A single punch will now check the card and tick off the participant. Have an extra Clear station available for participants who have forgotten to clear their cards.

OTG setup

Use a USB On-The-Go (OTG) adapter to attach a SPORTident station to the phone/tablet (an ordinary USB cable does not work). Note that the SPORTident station is normally powered by the host (the phone/tablet). To extend the battery life of the phone/tablet, an OTG adapter with separate power cable for the SPORTident station can be used.

SPORTident setup with USB On-The-Go adapter SPORTident setup with USB On-The-Go adapter and separate power cable SPORTident setup with SRR USB Dongle and BSF8-SRR-DB