Skip to content

mattwelborn/LiveSplit

 
 

Repository files navigation

Stories in Ready LiveSplit

A sleek, highly-customizable timer for speedrunners.

Contributing

We need your help!

You can browse the Issues to find good issues to get started with. Select one that is not already done or in progress, assign yourself and drag it over to "In Progress".

  1. Fork the project
  2. Clone your forked repo: git clone https://github.com/YourUsername/LiveSplit.git
  3. Create your feature/bugfix branch: git checkout -b new-feature
  4. Commit your changes to your new branch: git commit -am 'Add a new feature'
  5. Push to the branch: git push origin new-feature
  6. Create a new Pull Request!

Compiling

LiveSplit is written in C# 5 with Visual Studio and uses .NET Framework 4.0. To compile LiveSplit you can get any version of Visual Studio that supports .NET Framework 4.0, these include:

  • Visual C# 2010 Express
  • Visual Studio 2010
  • Visual Studio 2013 Express for Windows Desktop
  • Visual Studio 2013 Community Edition
  • Visual Studio 2013
  • Visual Studio 2015 Preview

Preferably you should either get a full version of Visual Studio 2013 or the Community Edition if you don't want to pay for Visual Studio.

Simply open the project with Visual Studio and it should be able to compile and run it without any further configuration.

Common Compiling Issues

  1. LiveSplit has a dependency on XSplit in order to work. If you are getting errors that say it can't find "VHMediaCOM", this is an XSplit thing. I suggest installing the free version of XSplit so the dependencies are registered on your computer.
  2. Could not build Codaxy.Xlio due to sgen.exe not being found. Open LiveSplit\Libs\xlio\Source\Codaxy.Xlio\Codaxy.Xlio.csproj in order to edit where it looks for this path. Look for <SGen...> where it defines the attribute "ToolPath". Look on your computer to find the proper path. It is typically down some path such as "C:\Program Files (x86)\Microsoft SDKs\Windows\x.xA...". Find the version you want to use and bin folder with sgen.exe in it and replace the path in the .csproj file.
  3. No submodules pulled in when you fork/clone the repo which causes the project not to build. There are two ways to remedy this:
  • Cloning for the first time: git clone --recursive git://repo/repo.git
  • If already cloned, execute this in the root directory: git submodule update --init --recursive

Adding an Auto Splitter

If you implemented an Auto Splitter and want to add it to the Auto Splitters that are automatically being downloaded by LiveSplit, feel free to add it to the Auto Splitters XML. Just click the link, click the icon for modifying the file and Github will automatically create a fork, branch and pull request for you, which we can review and then merge in.

License

The MIT License (MIT)

Copyright (c) 2014 Christopher Serr and Sergey Papushin

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

A sleek, highly-customizable timer for speedrunners.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 98.9%
  • PowerShell 0.5%
  • Java 0.5%
  • LSL 0.1%
  • Python 0.0%
  • Scheme 0.0%