LordMartin Replay Ripper documentation
Read also
release notes to find out what is new in 1.00+ LMRR versions.
LMRR is a freeware Win32 console application that converts actions from Starcraft replay file to text file. It can be very useful in any kind of analyses of recorded games (e.g. in MS excel). LMRR is also used by LM Replay Browser.
Currently LMRR supports only 1vs1 and 2vs2 replays.
NOTE: if in games are observers then first two players that execute build action are considered as replay players. This approach sometimes leads to taking observer as player. Perhaps I will change this method for something more reliable in future but misplacing players by observers occurres very very rare.
LMRR documentation
LMRR can by run in three modes
1. ripping single Starcraft replay file
LMRR.exe [options] "-fPath_To_Rep_file"
e.g. LMRR.exe "-fD:\starcraft\maps\replays\replay.rep"
2. ripping all Starcraft replay files in directory
LMRR.exe [options] [-/+r] "-dPath_To_Dir"
-r : rip replays only from directory Path_To_Dir (don't scan any
subdirectories). Default is -r.
+r : rip replays from directory Path_To_Dir and its all subdirectories
e.g. LMRR.exe +r "-dD:\starcraft\maps\replays"
3. ripping Starcraft replay files read from text file
LMRR.exe [options] "-iPath_To_file"
e.g. LMRR.exe "-iD:\starcraft\maps\replays\selected_reps.txt"
each line of selected_reps.txt file must contains path to replay file e.g
D:\starcraft\maps\replays\gosu rep.rep
D:\starcraft\maps\replays\mega gosu\megagosu rep.rep
NOTE: you must NOT mix these modes. You may run LMRR with -f OR -i OR -d
parameter.
[options] are consisted of the following parameters.
You may rip only some types of actions. However you can not rip specific actions on some type (e.g. rip only (train, marine) actions, you have to rip all train actions)
+u rip build units (hatch/train, e.g. train marine, hatch drone)
+g rip upgrades and researches (e.g. upgrade Protoss_Air_Armor)
+b rip build buildings
+h rip hotkeys (assign and select hotkey)
+v ally/vision
+c rip cancel actions
-upg update existing '.lmr' file. Replays files that ripped data exist in '.lmr' file won't be ripped. This is useful if u want to save your replay winner marks. Default is +upg (make a new rip).
NOTE: -upg forces -m.
+a treat all files in directory as replays. It may be useful if you have some files that are replays but have different extension.
+m deletes .lmr file
if file (specified in +o parameter) already exists will be overwritten. Set -m to append new ripped action to existing file. Default is +m.
+s rip select actions
+s don't rip ALL select actions. If some player execute a sequence of select
action then only the last one will be ripped.
+aa rip ALL actions
+u +g +b +h +c +s are INGONED
+sa set format of ripped actions to simple actions.
During normal ripping (-aa is default) each action parameters values and names are save. If +sa I used then only parameters values will be saved.
e.g. -sa 1440,4Or2,0,Build,12,1966189,Build,(125,33),Supply Depot
e.g. +sa 1440,0,12,1966189
SC time, player number, action ID, action argument
+n don't rip NULL actions
action is consider to be a NULL action if is the same as previous action.
NOTE: if player train e.g. two zealots (pressed z key twice) the second train action won't be ripped. However +n works good for most of build/upgrade/research/train/hatch actions and I recommend using it because it significantly reduce output file size.
"+oFile_Name" saves ripped actions to file File_name
e.g. "-onew2.lmr" will rip actions to new2.lmr file
if you miss this parameter actions will be rip to rep.lmr file
-tNumber rips action only before Number.
Number is in time format used by Starcraft. One second = 24 Starcraft time units.
e.g. -t14400 rips only first 10 minutes (10*60*24 = 14400)
Example usage of LMRR
LMRR.exe +sa +r +h +b +u +s +g +c "-opol.lmr" "-dD:\Starcraft\maps\replays\Pol"
This will rip all replays from D:\Starcraft\maps\replays\Pol (and its all subdirectories) to file pol.lmr. Actions (+h +b +u +s +g +c) will be saved in simple action format.