michaeljberk/splitter

A speedrunning timer for macOS

Splitter

A native Speedrunning timer for macOS

FAQ

Tips

Tip Jar

Download

Stable

The latest stable release of Splitter is available on the Mac App Store:

Download Latest Stable Release

Beta Testing

If you're a "thrill seeker", want to help test the next version of Splitter, or just like living on the edge, you can try out the latest beta release, which is based on the dev branch

(https://github.com/MichaelJBerk/Splitter/releases)

Discussion

You can suggest features, report issues, and contribute to the overall discussion about Splitter on the official Discord Server.

Supported Formats

Info about Splitter's native file format

In addition to the Splitter-native .split format, the app can edit and save the following: - LiveSplit (.lss) - Splits.io (.json)

Note that some features (such as appearance and color settings) are only saved to a .split file. As such, if you don't want to have to set them every time you open the file, it's recommended to save the file as .split (by clicking "File" -> "Save as..." in the menubar). If you need to need to share it with someone who isn't using Splitter, just open the .split file, and save it in whatever other format works best.

Building Splitter

If you want to build Splitter yourself:

• Install CocoaPods if you don't already have it installed
• Clone this repo
• run pod install in the project's root directory
  • You'll be prompted to set the secret and client keys for Splits.io, but you can press the Return key to leave them blank. See cocoapods-keys for more info.
• Open Splitter.xcworkspace in Xcode

Acknowledgements

LiveSplit Core

Splits.io

Files by John Sundell

MASShortcut by Vadim Shpakovski

Preferences by Sindre Sorhus

Sparkle by Sparkle Project

Cocoapods

splitter's Issues

Table column settings not imported when opening .split file

If the current window is "empty", and the user opens a file, close the "empty" window

Add support for opening splits.io JSON files from Finder

Look at reported issues with diffs on runs over an hour

Update import from LiveSplit to support new metadata

Allow the user to hide more columns

Currently, the user can only hide the best splits column. The user should be able to hide any column they want - icon, title, etc.

Add support for Time Split Tracker files

Redo Current and Best Splits

Try to emulate LiveSplit’s default behavior:

• The “current split” column displays your most recent attempt at the segment.
• “Diff” compares current with the most recent prior to it. There will be an option to compare it to your PB instead, and you can set it as the default, if you’d like
• “Best” automatically updates with the current time, if it’s the best.

Additionally, as a result of all this, existing .split files won’t work with the new version.

Add hidden column setting to splitter appearance file

It should store which columns the user has chosen to hide, not just "Best"

Authentication for splits.io

Diff doesn't update past the first segment when comparing to PB

Download splits from splits.io

Users can search for a game on splits.io, and choose a category for their run using a native UI. Splitter will then download the file, set all times to zero, and present it to the user

• After downloading the file, Splitter imports the data into a new .split file, instead of just opening the file that was downloaded. This allows the user to have access to all of Splitter's features without having to export the file first.

• Add support to Splits.io for filtering categories so that only categories with at least one run will appear.

• Add UI for downloading from splits.io

Colors are incorrect when opening LiveSplit and Splits.io files

When opening LiveSplit or Splits.io files, the background colors don't appear as the defaults - the Scroller background is different from the table background, and the header is somewhat transparent
(the window on the left is the correct appearance)

Fix SIGILL in Splitter.SplitterDoc.saveSplitFile(to: Foundation.URL, ofType: Swift.String, for: __C.NSSaveOperationType, delegate: Any?, didSave: ObjectiveC.Selector?, contextInfo: Swift.UnsafeMutableRawPointer?) -> () (SplitterDoc.swift:183)

Version 2.1(124)

Stacktrace

Splitter.SplitterDoc.saveSplitFile(to: Foundation.URL, ofType: Swift.String, for: __C.NSSaveOperationType, delegate: Any?, didSave: ObjectiveC.Selector?, contextInfo: Swift.UnsafeMutableRawPointer?) -> () (SplitterDoc.swift:183);Splitter

@objc Splitter.Document.save(to: Foundation.URL, ofType: Swift.String, for: __C.NSSaveOperationType, delegate: Any?, didSave: ObjectiveC.Selector?, contextInfo: Swift.UnsafeMutableRawPointer?) -> () (SplitterDoc.swift:242);Splitter

main (AppDelegate.swift:28);Splitter

Reason

SIGILL

Link to App Center

• https://appcenter.ms/users/mjosephberk/apps/SplitterTest/crashes/errors/635675208u

Usage of livesplit-core

Hey, I just found your new timer on Reddit and it looks pretty cool. And I found the GitHub repository for it as well and it looks like you are making use of livesplit-core, which is pretty neat. However you only seem to be using it for LiveSplit split files. However it can actually parse pretty much every split file format that we are aware of, so you don't actually need to implement any others yourself (such as the splits.io exchange format). Though you totally can, as especially for the splits.io exchange format we don't extract all the information it can have. Additionally I'm wondering if you are planning on using livesplit-core for other parts of the timer as we can do all the timing and implement all the LiveSplit components for easy consumption for any kind of frontend.

Update Backup Splits when a user adds/removes a split to/from the table

This will ensure that backup splits will be the same length as current splits.

Fix diff colors

Currently, it shows as the same as the global text color

Save diff colors to .split

Make current split clearer

Make it easier for the user to tell which split is the current split

Add column sizes to Splitter Appearance file

Save user's custom column sizes

Fix SIGILL in Crash Group # 2388193629u

Version 1.0(28)

Stacktrace

Reason

SIGILL

Link to App Center

• https://appcenter.ms/users/mjosephberk/apps/SplitterTest/crashes/errors/2388193629u

Make previous time column editable

Wrong color for table header when switching between differently colored windows

Setting the colors again fixes it

Remove legacy "hide Best Column" setting

It has been replaced with the new functionality that lets you hide any column.

• Remove from source code
• Remove from appearance file
• Remove from menu bar
• Remove from defaults

Change PB to individual segment time?

Fix SIGILL in main (AppDelegate.swift:28)

Version 2.0(106)

Stacktrace

main (AppDelegate.swift:28);Splitter

Reason

SIGILL

Link to App Center

• https://appcenter.ms/users/mjosephberk/apps/SplitterTest/crashes/errors/2149144233u

Fixup hotkeys

Use new dependencies for hotkeys, instead of the current implementation

Update .split documentation

make sure v1.0 format is 100% finalized

Fix issue when saving files without setting table color

Table color appears incorrect upon reopening a file if the table color wasn't changed before saving the new file

See if previous PB is still needed

Since we have a backup of the entire table, it may be redundant

Make attempts counter functional

Fix SIGILL in Splitter.ViewController.resetCurrentSplit() -> ()

Version 2.0(122)

Stacktrace

Splitter.ViewController.resetCurrentSplit() -> () (:0);Splitter

@objc Splitter.ViewController.resetCurrentSplitMenuItem(Any) -> () (Menu Items.swift:51);Splitter

main (AppDelegate.swift:28);Splitter

Reason

SIGILL

Link to App Center

• https://appcenter.ms/users/mjosephberk/apps/SplitterTest/crashes/errors/1952606056u

Fix export to Splits.io

Update import/export from splits.io to support new metadata

Cannot Save LiveSplit files

Not yet possible to export to .lss files.

Add help to individual keyboard shortcuts

On each shortcut, have a help button that explains exactly what it's supposed to do.

This can help ease confusion with commands such as Reset Run, which both resets the run, and sets the "current time" to zero.

Add window sizes to Splitter Appearance file

User's custom window size should be stored in Splitter Appearance

• No need for a "reset default" button for this - the smallest possible is the default, for the most part

Option to show previous times in current column when current time is zero

When opening a splits.io file, for example, the "current" column displays zero.

When this option is checked, the "current" column will display the previous time instead, when the current time is zero.

Update .Split format

.Split (or specifically, runInfo.json) should adopt the new data being stored for segments

Fix SIGILL in main (AppDelegate.swift:28)

Version 2.1(124)

Stacktrace

main (AppDelegate.swift:28);Splitter

Reason

SIGILL

Link to App Center

• https://appcenter.ms/users/mjosephberk/apps/SplitterTest/crashes/errors/4208562659u

Option to Notify user if they input a "best split" that's worse than their current split

Pros: User may not realize what they're doing and expect the current split to override it

Cons: If they do know what they're doing, it's annoying

Possible Solution: Notify by default, but give an option in the alert "Don't bug me about this again"

Override default shortcut

If a hotkey is set to a default shortcut (i.e. shift-cmd-s), after quitting the app and opening it again, the hotkey will not work

Hide diff until X seconds before showing negative

Need to also make it clearer which split is the current

Don't update previous value to 00:00:00.00

If the current value for a segment is 00:00:00.00, then don't update the "previous" column to the current value for that segment

Fix SIGILL in function signature specialization <Arg[0] = Owned To Guaranteed> of Splitter.TimeSplit.init(timeString: Swift.String) -> Splitter.TimeSplit (TimeSplit.swift:82)

Version 2.1(124)

Stacktrace

function signature specialization <Arg[0] = Owned To Guaranteed> of Splitter.TimeSplit.init(timeString: Swift.String) -> Splitter.TimeSplit (TimeSplit.swift:82);Splitter

function signature specialization <Arg[1] = Dead> of Splitter.ViewController.control(_: __C.NSControl, textShouldEndEditing: __C.NSText) -> Swift.Bool (:0);Splitter

@objc Splitter.ViewController.control(_: __C.NSControl, textShouldEndEditing: __C.NSText) -> Swift.Bool (:0);Splitter

main (AppDelegate.swift:28);Splitter

Reason

SIGILL

Link to App Center

• https://appcenter.ms/users/mjosephberk/apps/SplitterTest/crashes/errors/76692789u

Fix SIGILL in function signature specialization <Arg[0] = Owned To Guaranteed> of Splitter.TimeSplit.init(timeString: Swift.String) -> Splitter.TimeSplit (TimeSplit.swift:82)

Version 2.0(122)

Stacktrace

function signature specialization <Arg[0] = Owned To Guaranteed> of Splitter.TimeSplit.init(timeString: Swift.String) -> Splitter.TimeSplit (TimeSplit.swift:82);Splitter

function signature specialization <Arg[1] = Dead> of Splitter.ViewController.control(_: __C.NSControl, textShouldEndEditing: __C.NSText) -> Swift.Bool (:0);Splitter

@objc Splitter.ViewController.control(_: __C.NSControl, textShouldEndEditing: __C.NSText) -> Swift.Bool (:0);Splitter

main (AppDelegate.swift:28);Splitter

Reason

SIGILL

Link to App Center

• https://appcenter.ms/users/mjosephberk/apps/SplitterTest/crashes/errors/3362739272u

Reset Timer hotkey shouldn't restart timer

Add support for Llanfair files

Fix SIGILL in main (AppDelegate.swift:28)

Version 2.0(122)

Stacktrace

main (AppDelegate.swift:28);Splitter

Reason

SIGILL

Link to App Center

• https://appcenter.ms/users/mjosephberk/apps/SplitterTest/crashes/errors/3767582307u

Fix SIGILL in Splitter.ViewController.UpdateTimer() -> () (Timer Functions.swift:151)

Version 2.0(122)

Stacktrace

Splitter.ViewController.UpdateTimer() -> () (Timer Functions.swift:151);Splitter

@objc Splitter.ViewController.UpdateTimer() -> () (:0);Splitter

Splitter.ViewController.stopTimer() -> () (Timer Functions.swift:130);Splitter

closure #6 () -> () in Splitter.AppDelegate.keybindAction(keybind: Splitter.KeybindTitle) -> () -> ()? (Splits.swift:126);Splitter

Splitter.AppDelegate.setKeyMonitor(event: __C.NSEvent) -> () (AppDelegate.swift:79);Splitter

closure #1 (__C.NSEvent) -> () in Splitter.AppDelegate.MAStoStandardHotkeys() -> () (AppDelegate.swift:88);Splitter

reabstraction thunk helper from @escaping @callee_guaranteed (@guaranteed __C.NSEvent) -> () to @escaping @callee_unowned @convention(block) (@unowned __C.NSEvent) -> () (:0);Splitter

main (AppDelegate.swift:28);Splitter

Reason

SIGILL

Link to App Center

• https://appcenter.ms/users/mjosephberk/apps/SplitterTest/crashes/errors/966288818u