1
0
Fork
You've already forked mist
0
forked from periwinkle/mist
a minimal, improved speedrun timer
  • Rust 100%
2023年03月27日 21:00:56 +02:00
assets remove no-longer-necessary assets 2022年06月20日 11:00:31 -07:00
crates Implement in-game timer support through autosplitters 2023年03月08日 01:21:34 +01:00
src Accept a path to a split file as a command-line argument 2023年03月27日 21:00:56 +02:00
.gitignore chores 2022年06月20日 10:57:06 -07:00
.tokeignore add some badges to READMEs 2021年03月20日 12:05:12 -07:00
Cargo.lock cargo update 2023年01月03日 10:30:55 -07:00
Cargo.toml 2021 edition 2022年08月12日 22:59:28 -07:00
CHANGELOG.md change the log 2022年08月04日 17:08:09 -07:00
LICENSE-APACHE initial commit 2020年11月14日 21:29:25 -07:00
LICENSE-MIT initial commit 2020年11月14日 21:29:25 -07:00
README.md fix some old github links 2022年08月10日 21:31:01 -07:00

mist

Lines of code

a minimal, improved speedrun timer

Changelog

Latest Release

Planned features

Once all planned features are complete, I will likely stop developing this and only squash bugs etc. More might still be added to this list.

  • Cross platform
    • Linux
    • Windows
    • MacOS (builds, at least)
  • Human-readable split file (using ron)
  • LiveSplit split file transposing (split tool)
  • (limited) customizability
    • custom fonts/font sizes
    • custom colors
    • keybinds
    • timer backgrounds
    • panels (sum of best etc)
    • time rounding (30/60/off)
    • inline splits or use two rows
  • split file creation tool
    • edit existing msf
    • convert lss to msf
    • create new splits
    • actually good and usable (hardest part)
  • fps-based time conversion (so that the timer always ends on a time that corresponds to a possible frame time)
  • dynamic colors
  • different run comparisons
    • sum of best
    • pb
    • none
    • average
  • hot reloading
    • split file reloading
    • config reloading
  • plugins
    • autoloading from plugins directory (probably run as some kind of child process thing? or wasm?)
    • communicate with plugins through ipc (i.e. unix socket, windows named pipe)
    • plugins that are shipped with this repo (a discord presence, some kind of notes plugin, maybe more)
  • search for config/assets in standard os-specific dirs rather than hard-coded one (allows for packaging, installation, etc)
  • better way to find fonts than paths in config file
  • skip splits (because somehow i missed this all along)

Unplanned features

These features will not be implemented, in the spirit of minimalism (and maybe because I don't want to).

  • Autosplitters
  • Horizontal timer layout
  • Ingame time
  • Internet time sync
  • SRC/SRL/splits.io/racetime.gg integration
  • GIFs
  • Split icons

Installation

Compiling from source

Probably the best way to try this out is to compile it from source. To do this you need rust installed, and an installation guide for that can be found here.

Features

This package provides two features, bg and icon. icon sets the icon of the application when it is running, and requires sdl2_image. bg allows for configuration of a background image, and requires both sdl2_image and sdl2_gfx. To use only icon (removing gfx requirement), append

--no-default-features --features=icon

to the cargo commands below. For only bg, do the same except replace icon with bg. Finally, to remove both, remove the --features altogether.

Linux

Requirements are SDL2, SDL2_Image and SDL2_TTF shared libraries, as well as development libraries. On ubuntu:

sudo apt-get install libsdl2-2.0.0 libsdl2-ttf-2.0.0 libsdl2-image-2.0.0 libsdl2-gfx-2.0.0 libsdl2-dev libsdl2-ttf-dev libsdl2-image-dev libsdl2-gfx-dev

On arch:

sudo pacman -S sdl2 sdl2_ttf sdl2_image sdl2_gfx

Clone this repo (git clone https://codeberg.org/LieutenantPeriwinkle/mist), enter the directory, and run cargo build --release. The resulting binary will be located at ./target/release/mist

Windows

Follow this guide to set up your SDL dependencies. You will have to follow this process for SDL2, SDL_Image and SDL2_TTF, whose development stuff is available here and here. I had to use vcpkg to get sdl_gfx and then copy the .lib file to the folder specified by in the guide.

Compile with cargo build --release then move the exe as well as the sdl related dlls into the same folder to run.

MacOS

Install sdl2, sdl2 image, sdl2 gfx and sdl2 ttf. Using homebrew:

brew install sdl2 sdl2_image sdl2_ttf sdl2_gfx

Then you should be able to run cargo build --release.

Usage

The default keybinds are:

  • F1: Open new split file
  • F2: Open a new config file
  • Space: Start/split/stop
  • Enter: Pause/unpause
  • R: Reset
  • ←: Previous comparison
  • →: Next comparison
  • Mousewheel: Scroll splits up/down (if there are more than fit in the window)

Configuration

mist reads its configuration from the user configuration directory, specific to each operating system:

  • Linux: $XDG_CONFIG_HOME/mist/mist.cfg or $HOME/.config/mist/mist.cfg
  • Windows: \Users\YourUser\AppData\Roaming\mist\mist.cfg
  • MacOS: $HOME/Library/Application Support/mist/mist.cfg

Credits

Thanks to Xeryph and Komali for testing, bug reports, and help on things.

Licensing

Like Rust itself, mist is licensed under MIT or Apache 2.0, at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.