This documentation is OUTDATED! Go to /projects/mist/ instead!


mist ( is a speedrun timer written in Rust, targeting mainly Linux, but mostly supporting Windows and macOS. It started out as a series of projects that I used to learn Rust, back in 2019 or something. LiveSplit is essentially the industry standard when it comes to speedrun timers, but it only runs on windows, weighs 80MB, and doesn't really behave under wine, so I struck out to Make A Linux Speedrun Timer. Other options were out there but they either didn't work for me or were horribly unmaintained. The first attempts looked about how you can expect beginner projects to, but I feel that the current state of mist (in code, at least, if not functionality) is something I can be proud of. It's still incomplete, but should be usable for a majority of usecases. mist will never support the plethora of features available in LiveSplit, but it aims to be a competent tool containing most useful functionality.

Split files

mist stores information about a speedrun and its associated times in a ron file that looks something like this.

version 1
    game_title: "The Legend of Zelda: Breath of the Wild",
    category: "Any%",
    offset: None,
    pb: 9034,
    splits: [
        "old spice",
        "boom beach",
        "fireblight ez",
        "no reset",
        "the farm",
    pb_times: [
    gold_times: [
    sum_times: [
        (3, 7209),
        (3, 7091),
        (3, 6957),
        (3, 7057),
        (3, 7810),
        (3, 7260),
        (3, 8194),
        (3, 6405),
        (3, 7794),

I think a lot of the elements are fairly self-explanatory but here we go.


mist currently reads its configuration from the location assets/mist.cfg relative to the location of the binary, although this will be changed eventually. A configuration file is also in the ron format, and looks like this. In fact, this is the default config file.

    def_file: None,
    img_file: None,
    img_scaled: false,
    colors: ((0, 255, 0), (255, 0, 0), (255, 90, 90), (135, 255, 125), (255, 255, 0), (0, 0, 0)),
    frame_rounding: 30,
    layout: (
        inline_splits: true,
        panels_top: false,
        timer_top: false,
    panels: [],
    t_font: (
        system: false,
        path_name: "assets/DejaVuSans-Bold.ttf",
    s_font: (
        system: false,
        path_name: "assets/DejaVuSans.ttf",
    font_size: (60, 25),
    binds: (
        pause: "Return",
        reset: "R",
        start_split: "Space",
        skip_split: "Right Shift",
        un_split: "Backspace",
        prev_comp: "Left",
        next_comp: "Right",
        load_splits: "F1",
        load_config: "F2",

The elements of the file are as follows:

Frame Rounding

Time is, of course, continuous, meaning that a stopwatch or speedrun timer could theoretically display any sub-second value when stopped. However, this may be undesirable, for example in extremely short runs or just ones that require precise timing. Since games have discrete frames, it must take an integer number of frames to complete a run, which means that depending on the framerate of the game, only certain time values are "actually possible". mist supports displaying times compliant with any framerate, as specified by the frame_rounding configuration option. An example of frame rounding at 30 fps is as follows:

Real Time Rounded Time
1.456 1.467
0.633 0.633
3.913 3.933
4.892 4.900


Panels are used to display additional information about the speedrun in mist. There are three types of panels that can be put into the panels configuration option: SumOfBest, Pace, and CurrentSplitDiff. SumOfBest shows the sum of the runner's golds, theoretically their best possible time. Pace shows a "prediction" for the pace of the run, depending on the current status, such as how far behind or ahead the runner is. CurrentSplitDiff shows how far ahead or behind the runner is currently from the time on the current split that they are comparing against. The latter two are configurable as follows:

Pace( golds: true ),
CurrentSplitDiff( golds: false )

The golds option tells mist whether to compare against pb or against golds when calculating the times to display on these panels.