Results export and live data

FinishLynx writes each event's results to a .lif file, plain comma-separated text you can open in a text editor. Meet software (LynxPad, HyTek, RunMeet, MeetPro and others) reads the .lif, scores the event and exports CSV, PDF and other formats.

FinishLynx has no API, but there are two ways to get results out while a race is being evaluated.

How to fix it

Where the results files are

  1. FinishLynx saves the .lif to the Output Directory in File | Options | Database tab. The default is C:\Lynx, where FinishLynx is installed, and it can point at a shared network folder
  2. A .lif is written when the event is saved (File | Save, or File | Save LIF for the results only), as long as Write LIF File is On
  3. If no .lif appears, see Error writing .LIF file

Get results out in real time

  • Auto-save the LIF. Hold Ctrl+Shift and click File | Options… to open the hidden settings, then set Database\LIF\AutoSave to the save interval in seconds (0, the default, turns it off)
    • Another program can then watch the .lif for changes
    • Use FinishLynx 13.20 or later, which fixed auto-save not taking effect until the LIF was saved by hand once
  • Network scoreboard output. FinishLynx sends results over the network (TCP or UDP) through a scoreboard script, which is how live-results services and video boards receive data. See Results on a video board or TV
  • RunSignup. RaceDay Scoring imports the .lif files: follow its FinishLynx stream guide and point it at the Output Directory, with Write LIF File On. Questions about RaceDay Scoring itself go to RunSignup

Write start lists from your own software

  1. Meet software writes three plain-text, comma-separated files: lynx.evt (events, heats and athletes in lanes, the only file required), lynx.ppl (every registered athlete, so an athlete can be added by ID) and lynx.sch (the event order)
  2. Put them in the FinishLynx Input Directory, then open events with File | Goto Event and Load Schedule
  3. The file formats are in Database files in the manual, and a sample lynx.evt is installed in the Lynx folder (C:\Lynx). For example lynx.evt, lynx.ppl, lynx.sch and .lif files for your developer, use the button below

Demo mode

  • Without a serial, FinishLynx runs in demo mode. You can set up and test scoreboard output in demo mode on a serial port only, not over a network connection
  • Network (TCP or UDP) output works once FinishLynx is licensed

Can the LIF file be changed?

  • The LIF layout is fixed: its columns can't be reordered and new fields can't be added (known limitation)
  • To leave out the optional fields at the end, which some software can't read, set Database\LIF\ExtraFields to the last field to write: see the LIF fields card on the Other Settings page
  • For any other layout, a small program between FinishLynx and your software has to reformat the file

Logos on results

  • FinishLynx doesn't put a logo on the results it prints (known limitation). Add one to the PDF afterwards, or print from your meet software if it supports logos
  • Logos in live results (MileSplit, Athletic.net and others) come from the live-results platform or the timing company running it, not from Lynx. Ask them to change a wrong logo

Talk to Lynx Support

Tell the team what you’re seeing and what you’ve already tried. They’ll follow up by email or phone.

Contact Support