Skip to main content

Parse LiveSplit data

Project description

Livesplit-Parser

A Python Package to Parse Your Data Regarding Your Speedruns

This Pyton package parses LiveSplit files and parses data within LiveSplit files.

Install this package with pip install livesplit_parser

Check out the documentation for this package here.

Example Usage

from livesplit_parser import LivesplitData

lss_path = '' # put the path to your .lss file here
my_run = LivesplitData(lss_path)

print('NUMBER OF ATTEMPTS:', my_run.num_attempts)
print('NUMBER OF COMPLETED ATTEMPTS:', my_run.num_completed_attempts)
print('PERCENTAGE OF RUNS COMPLETED:', my_run.percent_runs_completed)
print('YOUR ATTEMPT DATA\n:', my_run.attempt_info_df)
print('YOUR SPLIT DATA:\n', my_run.split_info_df)

TODO Features to Include

  • Include a StandDev column in the split_info_df that includes the standard deviation of all your attempts for that split
  • Plot split time distributions using violinplots
  • Plot runtime distributions with the splits on the x-axis and standard deviation on the y-axis
  • Plot number of runs that reset between completed runs
  • Plot completed runs over time (run ID on x-axis, final time on y-axis)
  • Plot completed runs with a heatmap showing how good that segment was for that run
  • Create a Runner class that contains a list of Runners with their data and methods that plot runs against each other
    • example: plot each runner's PB over time (runners can compare themselves against each other)
    • another example: heatmap from before with splits on the x-axis, runner on the y-axis, and heatmap comparing that segment with the means of the personal bests of every runner included

Other ideas for plots and features can be submitted to the Issues board on my GitHub repo :)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

livesplit_parser-0.2.3.tar.gz (8.7 kB view details)

Uploaded Source

Built Distribution

livesplit_parser-0.2.3-py3-none-any.whl (8.3 kB view details)

Uploaded Python 3

File details

Details for the file livesplit_parser-0.2.3.tar.gz.

File metadata

  • Download URL: livesplit_parser-0.2.3.tar.gz
  • Upload date:
  • Size: 8.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for livesplit_parser-0.2.3.tar.gz
Algorithm Hash digest
SHA256 e41152a2886cc90370c02fb6f9481d8b87cee61f1be3cb8c4cab775c240ff3be
MD5 f9699e0ffaf6222e57d16b11aebc7c22
BLAKE2b-256 af103865ee16ed08f49c06e558cd1b5773ef484c9f96a8f47e1690e8713aead5

See more details on using hashes here.

File details

Details for the file livesplit_parser-0.2.3-py3-none-any.whl.

File metadata

File hashes

Hashes for livesplit_parser-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 eba7cd47f019b9b64f20aafae1ac24b9b791fc31b740ee8ede1309f9c405d892
MD5 5ddba87232a513c0852b313076fc4bd9
BLAKE2b-256 8ffc7f7300c202d9456070f29641e992ec12dd85abe19e5f4dbe08625de27a2d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page