I also made an update the files and manual to help make this more clear. Thread here:
Recent community posts
I updated the sample files and the manual. It should be a bit more clear what the columns mean, and how the files should be set up. Here is a link to the files until these are added to the next update.
This section in the manual for the file format was modified to explain the columns better:
The first column is the title, and in the following lines, the name of the splits.
The second column is the best splits. This stores as an elapsed time, not run time, the fastest elapsed time for the split. Displaying this column as run time will show the accumulated times and will show as the final split what the optimal run time should be.
The remainder of the columns except the last are for comparison splits, used to compare the current run against multiple sets of splits.
The last column is the best run. This is the splits that will be replaced when saved.
You need to have a column between the split name and the Best Run (you can rename this columns), which is Best Splits, which is the time (stored as duration) for that split. This column adds up each duration in the column and shows a guess for the optimal best run.
I see that the file that you based this on is incorrect for some reason. I don't know how that slipped by for all this time. I will update this for the Windows/WINE version, and have Time Split Tracker add the best splits column automatically if there is only one column, and pass them along to Eric whenever he comes back.
The ini file does indeed controls the settings, provided that the settings have been implemented, which many have not been in the mac version. The windows version has everything implemented, including the ability to edit split files. I also actively maintain it. It runs great in WINE; I use Linux so I run it in WINE, and have tested it.
When are you trying to save your best splits? It should save them automatically if the option for auto-save best splits is set, if that exists in the mac port. I don't have a mac, so I am unable to test. Hotkey options don't exist yet, as well as a number of settings.
I posted the corrected file in the other thread.
For reference to anyone else with this happening, the first time column is reserved for the best splits, and is stored as the elapsed time for the individual split only. The last column is the one used as the best run, which is stored as the run time.
You can optionally insert columns in-between which are comparison splits used as information only, and is not modifed by a best run. They are also stored as the run time. An example for this is when you want to compare your best run against a world record. You put the WR in the middle column and your best run in the last. When you are running, you can see how the current run compares to both your best run and the WR.
That part of the customization has not been implemented yet on the Mac version.
(If you want, you can run the Windows version through WINE to have all features, and use it until the features are available on the Mac version.)
After Time Split Tracker opens, you have to load a split file (otherwise you can use it as a simple timer). There are example split files as a template, or you can post your splits here and I will make a file for you.
There are settings to adjust the height and width that are set separately. In the ini or preference file, there should be a section for window settings. It should be the lines under the line that is
There are bunch of settings, but these are relevant to what you need:
HeaderColumnWidth sets the width of the split name column.
DataColumnWidth sets the width of the remainder of the rows.
HeaderColsHeight sets the height of the column header line.
RowHeight sets the height of the rows for the splits.
I think these settings are enabled in the Mac version. I am the programmer for the Windows/WINE version, so I am going on how it should work.
It appears that the format of the downloaded file from splits.io is incorrect. I have emailed them about this issue.
For now you can fix this by adding a second column for the best run (just add a tab and type "best run" in the header row). The first column is used to store the best individual splits. You can also tell me what file you are downloading and I can fix it manually.
For future reference (for others searching the threads), it is not a formatting issue. The times in the best splits column are stored as each split's duration, but the times in the best run column (and comparison run columns) are stored as the actual run time at each split.
Ah, you need another column after best splits for the best overall run. Time Split Tracker requires that because its primary feature is tracking the best run's splits. Without that column, the best splits column is being treated as a best run.
Can you provide the splits file that you used with Time Split Tracker before you did your run (and also afterward, which might be helpful to have the save try to fix the format)? It sounds like it may have been in an incorrect format. Also, what did you use to export the file for use with Time Split Tracker? I wonder if the export process is faulty.
I believe those features (and many other settings from the ini file) have not yet been implemented for this version. I cannot verify it since I do not develop this version (and cannot run it).
The image folder (or any folder) is not a requirement. The path seems correct (it is based off the location of the program file, not the splits file), but I would want to verify that the split file is formatted correctly. The image path should be the first column in the second line of each split.
I can certainly help you create a split file if you would like. The file is what defines and stores the splits and their times, so it is essential to have a file that has the splits for the run you are doing. There are sample split files that come with Time Split Tracker.
Another way to set up the split file if you have WINE installed is to get the Windows version (or just borrow someones windows machine for a bit) and use it to edit the splits within the program. I hope this feature will be added to the Mac version soon.
Here is the section from the manual about the format of the split file:
File Format for Splits File: The files Time Split Tracker uses are tab delimited, so it is easily to modify this in a spreadsheet program. Just save it as a tab delimited.
The first line is the info for the file. Its first column is the total number of attempts for the splits. The second column is the TimeOffset; the amount of time (can be negative) to offset the timer's starting time from zero. The third column is the path and filename for the image for the splits file. This is relative to the split file's location. This is what is displayed next to the splits' title.
The next line has the headers for the columns. The first column is the title for the splits. The second column is "Best Splits" which will be overwritten by the program since it is a reserved column. The remainder of the columns are for the comparison splits.
The remainder of the lines are in pairs and have the split data. The first line in the pair is the time data for the split. The first column is the split name, and the remainder are the times for the split, except the best split which is the elapsed time. The format must be in h:mm:ss.zz (zz is the hundredths of the second) or it will not be recognized properly. The number of time data must match the number of headers. The second line in the pair is the row's image file and the split notes. The first column is the path and filename of the image for the split. This is relative to the split file's location. The rest of the columns are the notes for each time in the split. Note that in a text editor/spreadsheet, a tab must be entered as |t and a return as a |n since the characters normally would break the file format. These show up normally in the the notes editing in Time Split Tracker.
You need to unzip the download into a folder which can be put anywhere you like, that is the installation process for Time Split Tracker. The next step after opening Time Split Tracker is to open one of your split files (command-O should do it, or you can do that from the menu). The default mode of the program is a timer without any splits.
The commands to use the timer should be in the splits menu (it is in the windows version, and the operation should be the same for the two versions) but you hit space to start the timer and go to the next split, hit P to pause and resume the timer, R to reset the timer, K to skip a split, and backspace to undo a split. They key commands are also listed in the ini file, and are customizable, though I don't know if the mac version has implemented that yet.
The mac version of Time Split Tracker does not yet have in-program split file editing. The second post in this thread is the file format copied from the manual. Alternatively, if you have another computer (or dual-boot) with windows, or if you have WINE, you can use the windows version to edit the split file. To create a split file you copy one of the templates and edit it. Or if you want to post the info for the splits, I will post back the data for the split file.