You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+12-11
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@
3
3
4
4
Easy to use image comparison based auto splitter for speedrunning on console or PC.
5
5
6
-
This program compares split images to a capture region of any window (OBS, Streamlabs, etc.) and automatically hits your split hotkey when there is a match. It can also be used to start and reset your timer, allowing for it to take full control of starting, splitting, and resetting your timer without ever having to touch a hotkey. It can be used in tandem with any speedrun timer that accepts hotkeys (LiveSplit, wsplit, etc.), but can be integrated with LiveSplit.
6
+
This program can be used to automatically start, split, and reset your preferred speedrun timer by comparing images to a capture region. This allows you to focus more on your speedrun and less on managing your timer. It also improves the accuracy of your splits. It can be used in tandem with any speedrun timer that accepts hotkeys (LiveSplit, wsplit, etc.), and can be integrated with LiveSplit.
7
7
8
8

9
9
@@ -17,7 +17,7 @@ This program compares split images to a capture region of any window (OBS, Strea
17
17
18
18
### Opening the program
19
19
20
-
- Download the [latest version](/../../releases)
20
+
- Download the [latest version](/../../releases/latest)
21
21
- Extract the file and open AutoSplit.exe.
22
22
23
23
### Building
@@ -38,7 +38,7 @@ This program compares split images to a capture region of any window (OBS, Strea
- Custom split image settings are handled in the filename. See how [here](#custom-split-image-settings).
41
-
-Images can be created using Print Screen, [Snipping Tool](https://support.microsoft.com/en-us/help/4027213/windows-10-open-snipping-tool-and-take-a-screenshot), or AutoSplit's Take Screenshot button.
41
+
-To create split images, it is recommended to use AutoSplit's Take Screenshot button for accuracy. However, images can be created using any method including Print Screen and [Snipping Tool](https://support.microsoft.com/en-us/help/4027213/windows-10-open-snipping-tool-and-take-a-screenshot).
42
42
43
43
## Capture Region
44
44
@@ -60,10 +60,9 @@ This program compares split images to a capture region of any window (OBS, Strea
60
60
### Comparison Method
61
61
62
62
- There are three comparison methods to choose from: L2 Norm, Histograms, and pHash.
63
-
- L2 Norm: This method finds the difference between each pixel, squares it, and sums it over the entire image and takes the square root. This is very fast but is a problem if your image is high frequency. Any translational movement or rotation can cause similarity to be very different.
63
+
- L2 Norm: This method should be fine to use for most cases. it finds the difference between each pixel, squares it, and sums it over the entire image and takes the square root. This is very fast but is a problem if your image is high frequency. Any translational movement or rotation can cause similarity to be very different.
64
64
- Histograms: An explanation on Histograms comparison can be found [here](https://mpatacchiola.github.io/blog/2016/11/12/the-simplest-classifier-histogram-intersection.html). This is a great method to use if you are using several masked images.
65
65
- pHash: An explanation on pHash comparison can be found [here](http://www.hackerfactor.com/blog/index.php?/archives/432-Looks-Like-It.html). It is highly recommended to NOT use pHash if you use masked images. It is very inaccurate.
66
-
- Note: v1.0 used L2 Norm.
67
66
68
67
### Show Live Similarity
69
68
@@ -110,7 +109,7 @@ This program compares split images to a capture region of any window (OBS, Strea
110
109
-`001_SplitName_(0.9)_[10].png` is a split image with a threshold of 0.9 and a pause time of 10 seconds.
111
110
-`002_SplitName_(0.9)_[10]_{d}.png` is the second split image with a threshold of 0.9, pause time of 10, and is a dummy split.
112
111
-`003_SplitName_(0.85)_[20]_#3500#.png` is the third split image with a threshold of 0.85, pause time of 20 and has a delay split time of 3.5 seconds.
113
-
-`004_SplitName(0.9)_[10]_#3500#_@3@_{b}.png` is the fourth split image with a threshold of 0.9, pause time of 10 seconds, delay split time of 3.5 seconds, will loop 3 times, and will split when similarity is below the threshold rather than above.
112
+
-`004_SplitName_(0.9)_[10]_#3500#_@3@_{b}.png` is the fourth split image with a threshold of 0.9, pause time of 10 seconds, delay split time of 3.5 seconds, will loop 3 times, and will split when similarity is below the threshold rather than above.
114
113
115
114
### How to Create a Masked Image
116
115
@@ -126,7 +125,7 @@ You can have one (and only one) image with the keyword `reset` in its name. Auto
126
125
127
126
### Start image
128
127
129
-
The start image is similar to the reset image. You can only have one start image with the keyword `start_auto_splitter`.You can reload the image using the "`Reload Start Image`" button. The pause time is the amount of seconds AutoSplit will wait before checking for the start image once a run ends/is reset.
128
+
The start image is similar to the reset image. You can only have one start image with the keyword `start_auto_splitter`.You can reload the image using the "`Reload Start Image`" button. The pause time is the amount of seconds AutoSplit will wait before checking for the start image once a run ends/is reset. Delay times will be used to delay starting your timer after the threshold is met.
130
129
131
130
### Timer Global Hotkeys
132
131
@@ -166,18 +165,19 @@ If this option is disabled, when the reset hotkey is hit, the reset button is pr
166
165
167
166
- Settings files use the extension `.pkl`. Settings files can be saved and opened by using File -> Save Settings As... and File -> Load Settings. A settings file can be loaded upon opening AutoSplit if placed in the same directory as AutoSplit.exe.
168
167
- The settings in the settings file include split image directory, capture region, capture region dimensions, fps limit, threshold and pause time settings, all hotkeys, "Group dummy splits when undoing/skipping" check box, "Loop Split Images" check box, and "Auto Start On Reset" check box.
168
+
- You can save multiple settings files, which is useful if you speedrun multiple games.
169
169
- If you are upgrading to Windows 11, it's possible that save files may not transfer perfectly. You may need to readjust or reselect your Capture Region, for example.
170
170
171
171
## LiveSplit Integration
172
172
173
173
The AutoSplit LiveSplit Component will directly connect AutoSplit with LiveSplit. LiveSplit integration is only supported in AutoSplit v1.6.0 or higher. This integration will allow you to:
174
174
175
-
- Use hotkeys directly from LiveSplit to control AutoSplit.
175
+
- Use hotkeys directly from LiveSplit to control AutoSplit and LiveSplit together
176
176
- Load AutoSplit and any AutoSplit settings automatically when opening a LiveSplit layout.
177
177
178
178
### LiveSplit Integration Tutorial
179
179
180
-
- Click [here](https://github.com/Toufool/LiveSplit.AutoSplitIntegration/raw/main/update/Components/LiveSplit.AutoSplitIntegration.dll) to download the component.
180
+
- Click [here](https://github.com/Toufool/LiveSplit.AutoSplitIntegration/raw/main/update/Components/LiveSplit.AutoSplitIntegration.dll) to download the latest component.
181
181
- Place the .dll file into your `[...]\LiveSplit\Components` folder.
182
182
- Open LiveSplit -> Right Click -> Edit Layout -> Plus Button -> Control -> AutoSplit Integration.
183
183
- Click Layout Settings -> AutoSplit Integration
@@ -194,18 +194,19 @@ The AutoSplit LiveSplit Component will directly connect AutoSplit with LiveSplit
194
194
195
195
## Resources
196
196
197
-
- Still need help? [Open an issue](../../issues)
197
+
Still need help?
198
+
-[Open an issue](../../issues)
198
199
- Join the [AutoSplit Discord](https://discord.gg/Qcbxv9y)
199
200
200
201
## Credits
201
202
203
+
- Created by [Toufool](https://twitter.com/Toufool) and [Faschz](https://twitter.com/faschz).
202
204
-[Harutaka Kawamura](https://github.com/harupy/) for the snipping tool code that I used to integrate into the autosplitter.
203
205
-[amaringos](https://twitter.com/amaringos) for the icon.
204
206
-[ZanasoBayncuh](https://twitter.com/ZanasoBayncuh) for motivating me to start this project back up and for all of the time spent testing and suggesting improvements.
205
207
-[Avasam](https://twitter.com/Avasam06) for their continued work on making an incredible amount of improvements and changes to AutoSplit while I have not had the time/motivation to do so.
206
208
-[KaDiWa](https://github.com/KaDiWa4) for the LiveSplit integration.
207
209
-[Tyron18](https://twitter.com/Tyron18_) for assisting with Windows 11 testing.
208
-
- Created by [Toufool](https://twitter.com/Toufool) and [Faschz](https://twitter.com/faschz).
0 commit comments