|
![[image loading]](http://i.imgur.com/TB9Tz.png)
Hi TL,
Introduction
I present to you SC2ReplayHandler. A utility that automatically renames/stores/cleans replay files to keep things neat. the software monitors the folder(s) that your replay files are saved at, and then renames/copies them based on meta information in the files to a more managable naming convention that you can customize on your own using placeholders.
This will forever remain FREE, at some point I intend to release this as Open Source.
Im always happy to accept any sort of feedback and add/change things as time goes by, since even though I had quite a few users for the initial beta, different people come with different needs, so feel more than welcome to post requests in comments or PM me.
Examples
+ Show Spoiler +
- "somefile1.SC2Replay" --> "2012-01-16 PvT on Antiga Shipyard - WhiteRa vs EmpireKas.SC2Replay"
- "somefile2.SC2Replay" --> "Private Game - WhiteRa(P) vs EGIdrA(Z) on Xel'naga Caverns [ver1.4.2.20141].SC2Replay"
Common uses for the tool can be ( based on beta users feedback so far )
- Replay file management
- Creating copies of your own ladder games for replay packs
- Cleanup
Why Did You Write It ?
For a while now I wanted to try and do something for the general SC2 community, I guess EGiNcontrol's blog last year helped in finding some motivation, then A few days ago I stumbled upon Ascend's library, which made me decide to try and solve something that me and some friends were talking about - effortless replay housekeeping.
anyway, I guess every one can contribute in their own ways, this is mine.
How Does It Work ?
The software monitors the folders where Replays are saved/kept at, and on the appearance of a new replay, it parses it for information such as player names and races, maps, dates, matchups, etc ... and then renames the file and possibly copies/moves it for you, therefor keeps it hassle-free. also, since its .NET based and does nothing else fancy, its really fast and barely uses resource.
Latest Version : 1.18
Last Update : 03-02-2012
Download
Click Here to download the latest package.
User Group and Bug Report
Click Here for the Google Group to discuss bugs, and usage. version announcements are automatic for group members.
Instructions
+ Show Spoiler +Install and Basic Configuration- extract the files to a directory of your choice
- run the SC2ReplayHandler.exe
- in the system tray, right click on the Icon and press "Settings"
- follow the easy steps of Lookup-Match-Rules which means --
- in "Lookup" you choose where the replays are saved on your computer, which is normally "C:\Users\USERNAME\Starcraft II\Accounts\" ( including subdirectories ).
- in "Match" you define which type of files to look at ? specific player files, ladder only, or if no criteria is chosen then - Everything.
- "Rules" - what should we actually do with files we find..
- the "File Pattern" is the most important one, since it describes the structure of the name of files after rename, click on the arrow for examples and on "Legend" for the place holder list.
- once done hit "Ok"
you are now done with the configuration. note the following : - it is recommended to Run manually once by right clicking on the tray icong Run >> Run Now, since it will go through everything in the lookup folder for the first time
- the software listens to windows events, everytime a new file is added to the directory you monitor, it will invoke the tool
- on first run, the software might ask you to update your ".NET Framework" through Microsoft's Windows Update
it is recommended to put a link to the sotware in the Start>>Programs>>Startup folder, so the tool automatically loads for you and you dont have to think about it, after all... effortless is the idea ... here is a Video that should simplify usage : http://www.youtube.com/v/zKce5nfZMpw
Screenshots
+ Show Spoiler +settings![[image loading]](http://i.imgur.com/vmQ0r.png) tray icon![[image loading]](http://i.imgur.com/jAlzz.png) placeholder legend![[image loading]](http://i.imgur.com/peGlW.png)
Changelog
+ Show Spoiler +
v1.18
- rewrote the log mechanism for debug messages, much more verbose now.
- improved MD5 utility
- fixed a bug where 2 or more replays that appear to be the same, only first will be handled.
- fixed a bug where date was not the correct date of the actual replay.
- new behavior, if a resulting file name for 2 diffrent files is the same, a __UID<number> will be added
v1.17
- new settings.xml required, previous users need to reconfigure.
- added [MD5SC2GEARS] predicate that outputs the same MD5 Hash format as SC2Gears
- added Sort function that always matches the selected player as Player 1
1.16
- added a choice on the specific folder execution, to choose rename only or use all rules
- changed the Legend screen into a more readable screen
v1.15
- fixed a bug where if you change folders you needed to restart the tool
- fixed a bug where version would show game length instead
- added [VER] which is like [VERSION] but only show 3 digits of the version ( i.e. "142" )
v1.1
- added [MD5] option, that calculates MD5 hash based on the file.
- added [LENGTH] option, that returns the total running minutes of the replay.
- fixed the legend, it missed "[MAP]" even though it was coded.
v1.0
- Initial Release.
Libraries Used and other Credits
+ Show Spoiler +- SC2Replay-CSharp by Ascend - MpqLib by Magos - the Icon is a variation of Ascend's Starboard Icon, using the PSD. - thanks András Belicza (author of SC2Gears ) for the MD5 Encoding algorithm of SC2Gears
all I can conclude with is some wishes for you all..
never Stim in front of children, dont Forcefield other people's ramps, and always clean after yourself when injecting Larvae.
GLHF!
Sectorix.
|
Why would I use this over SC2 Gears when I already have that up and running?
|
On January 17 2012 05:58 Barett wrote:
Why would I use this over SC2 Gears when I already have that up and running?
I use SC2Gears too, mostly for analysis. its just a different approach i guess.. i wanted something that runs regardless to anything and does things without me having to remember run, and a few ppl i know have asked me if i can write something like this. you can use either or both... choice is great isnt it ? 
Edit : also some comments i got from users that downloaded is that its really fast since it does only that, plus runs on .NET and not Java.. i didnt check but thats the feedback.
|
Actually this is very useful to me.
SC2Gears was a bit too heavy to run at the same time as SC2 on my computer, and made split seconds freezes from time to time, so I stopped using it. Because of this, to save replays, I had to manually select all replays in the Multiplayer folder, then "Rename all" and "Move all" every time. I also couldn't put downloaded replays in a subfolder in Multiplayer, because SC2Gears includes subfolders, which means I couldn't use the ingame menu to watch replays I've downloaded.
This seems to be much lighter, has an option to exclude subfolders, and can be run seperately after a game session in one click.
The only thing missing right now is that I can't completely simulate the rename pattern I was using in SC2Gears because it's missing the MD5 tag option. Adding MD5 as part of the name apparently speeds up searches and analysis in SC2Gears which is why I'm saving all these replays to begin with. If you could add that, that would completely replace my use of SC2Gears replay save.
|
On January 17 2012 06:32 Wiwiweb wrote:
Actually this is very useful to me.
SC2Gears was a bit too heavy to run at the same time as SC2 on my computer, and made split seconds freezes from time to time, so I stopped using it. Because of this, to save replays, I had to manually select all replays in the Multiplayer folder, then "Rename all" and "Move all" every time. I also couldn't put downloaded replays in a subfolder in Multiplayer, because SC2Gears includes subfolders, which means I couldn't use the ingame menu to watch replays I've downloaded.
This seems to be much lighter, has an option to exclude subfolders, and can be run seperately after a game session in one click.
The only thing missing right now is that I can't completely simulate the rename pattern I was using in SC2Gears because it's missing the MD5 tag option. Adding MD5 as part of the name apparently speeds up searches and analysis in SC2Gears which is why I'm saving all these replays to begin with. If you could add that, that would completely replace my use of SC2Gears replay save.
thanks for the feedback, ill add MD5 for the next release. right now i'm collecting some feedback from people like yourself to see if anything is missing, i was also asked for Game Length, which i will add as well.
|
Update to version 1.1 -- download link updated.
changes ( also in changelog ) :
- added [MD5] option, that calculates MD5 hash based on the file.
- added [LENGTH] option, that returns the total running minutes of the replay.
thanks Wiwiweb for the suggestion.
|
Works great Barry.
Thanks for this :D
Question, what's the best way to update this then?
Just download the new package and run it? (If I do that, I have to re-enter all of the pathing and settings)
|
On January 17 2012 07:42 Fruity wrote:
Works great Barry.
Thanks for this :D
Question, what's the best way to update this then?
Just download the new package and run it? (If I do that, I have to re-enter all of the pathing and settings)
to update, overwrite the files from the package. but you can keep "settings.xml" which contains your configuration.
unless, its stated in the Changelog that it contains new settings.xml file ( if i add functionality of some sort ) then new settings file need to be used
|
Wow!
This is one sick addon!
|
awesome stuff, thanks alot for investing your time in such a small, yet very useful program , tbh , i know alot of ppl that used sc2gears only for the sake of the replay saving so this will be very useful for them , and for me too!
keep up the great work !
|
thanks for the support
due to some feedback i got i did update to fix a couple of bugs that were pointed out, plus added a [VER] predicate for a short 3 digit version name ( for example for 1.4.2.20141 it will show 142 ).
i also have some very good feedback so far on performance and low mem/cpu/io even with very large libraries. thanks for those of you who sent me messages so far.
|
On January 17 2012 07:26 Sectorix wrote:
thanks Wiwiweb for the suggestion.
No, thank you for adding it
|
Updated to 1.16, this is mostly cosmetic to add an easier to read Legend screen and add some more basic functionality to the specific folder execution.
I would have waited until i add more stuff, but some users complained that the legend screen was hard to read, so I remade it.
screenshot :
+ Show Spoiler +new Legend screen
|
For some reason the MD5 I get from a replay doesn't seem to end up being the same with SC2Gears and SC2ReplayHandler... Multiple ways of calculating MD5?
![[image loading]](http://i.imgur.com/WM3Jc.jpg)
( I used "[DATE] - [MATCHUP] - [MAP] (MD5_[MD5]).[EXT]" )
I don't really know the technical details, but as long as the name is different for every replay, it should still improve search speed, so it shouldn't matter, right? If you really want to follow SC2Gears's pattern, you can change this I suppose.
|
well, look at a tools like MD5sums for Windows , it produces the value that my MD5 hash calculation creates, so its the correct MD5. I believe that SC2Gears does an interpretation on the MD5 and doesnt use the actual hash, maybe it does a Base64 on it or something similar.
i believe speed is the same as long as you use a hash, regardless to which one, but that's my concept of it.
|
Dakota_Fanning
Hungary2359 Posts
On January 18 2012 06:07 Sectorix wrote:well, look at a tools like MD5sums for Windows , it produces the value that my MD5 hash calculation creates, so its the correct MD5. I believe that SC2Gears does an interpretation on the MD5 and doesnt use the actual hash, maybe it does a Base64 on it. from what i've tested the speed is the same as long as you use a hash, regardless to which one, but that's my experiance with it.
Unfortunately this is not the case.
MD5 is a standard algorithm, Sc2gears does not re-define it. After calculating the MD5 Sc2gears shortens it (encodes it) so the file name will be shorter (as seen in the picture). Using the original MD5 will not result in faster search and analysis. If it's not the same as produced/expected by Sc2gears, it will not give speed advantage.
|
On January 18 2012 06:57 Dakota_Fanning wrote:Show nested quote +On January 18 2012 06:07 Sectorix wrote:well, look at a tools like MD5sums for Windows , it produces the value that my MD5 hash calculation creates, so its the correct MD5. I believe that SC2Gears does an interpretation on the MD5 and doesnt use the actual hash, maybe it does a Base64 on it. from what i've tested the speed is the same as long as you use a hash, regardless to which one, but that's my experiance with it. Unfortunately this is not the case. MD5 is a standard algorithm, Sc2gears does not re-define it. After calculating the MD5 Sc2gears shortens it (encodes it) so the file name will be shorter (as seen in the picture). Using the original MD5 will not result in faster search and analysis. If it's not the same as produced/expected by Sc2gears, it will not give speed advantage.
thank Dakota_Fanning, i will check with you regarding the option to use the same encoding.
love your work btw !
|
This is really cool.
Would it be possible to include an option that lists the specifically selected player (and their race) first, irrelevant of whether they're actually Player 1 or 2 or whatever?
Since I sometimes moonlight as Protoss / Zerg, this would make it easier to identify replays from those times, and see the race I'm playing and what race I'm playing against. So PvT would always mean I was Protoss, and TvP would always mean I was Terran, instead of having to guess.
|
On January 18 2012 07:51 netherh wrote:
This is really cool.
Would it be possible to include an option that lists the specifically selected player (and their race) first, irrelevant of whether they're actually Player 1 or 2 or whatever?
Since I sometimes moonlight as Protoss / Zerg, this would make it easier to identify replays from those times, and see the race I'm playing and what race I'm playing against. So PvT would always mean I was Protoss, and TvP would always mean I was Terran, instead of having to guess.
you got it, i will add it to the next build.
|
Updated to 1.17
- thanks to Dakota_Fanning, added the calculation of the SC2Gears compatible MD5 Encoded Hash.
- added the sort by selected player functionality
- this build requires scratch config, since the settings.xml changed.
|
|
|
|
|
|
EPT
