|
Dakota_Fanning
Hungary2360 Posts
I've created and open-sourced a command line StarCraft: Brood War replay parser tool called screp here:
https://github.com/icza/screp
What it is
It's a standalone app with no GUI, and it can be used from the command line to pass a StarCraft: Brood War replay file to it (.rep), and it will parse the file and display low-level information from the replay in textual, JSON representation.
Target audience
While anyone may download it and use it, the information it presents is quite low level. It is human readable (JSON), but it's primarily intended for developers and web sites that wish to extract data from replays.
Supported platforms
Pre-built binary releases are provided for Windows, Linux and MAC OS X, both for 32 and 64-bit architectures.
Note that the project is written using the Go language, which supports a lot more platforms. Should you need to use it on other platforms, you can checkout the source code and compile it on your platform.
Requirements
Nothing is required. screp is shipped as a single, self-contained executable binary. It has no dependency. You do not need anything installed on your system. You just download the binary for your platform, extract it and use it.
Supported replay versions
Parses both "modern" (starting from 1.18) and "legacy" (pre 1.18) replays.
Download
Pre-built binaries can be downloaded from:
https://github.com/icza/screp/releases
Feedback / Bug report
Feedback and bug report is welcome. Feedback may be posted here, bugs and issues should be reported at:
https://github.com/icza/screp/issues
Star / Follow the project
If you like the project, please star it / watch it / follow me on github. Thanks.
Also check out the sister project to parse StarCraft II replays: s2prot
|
thx, gonna use it unless it requires additional shit
|
could you also add your eapm algorithm from bwhf agent? Btw i love that tool, use it a lot back in the days
|
Dakota_Fanning
Hungary2360 Posts
On May 22 2017 23:56 mca64Launcher_ wrote:
thx, gonna use it unless it requires additional shit
It's a single, self-contained binary. It requires nothing else.
On May 22 2017 23:57 mca64Launcher_ wrote:
could you also add your eapm algorithm from bwhf agent? Btw i love that tool, use it a lot back in the days
You might wanna add that as a request at https://github.com/icza/screp/issues. Based on popular demand it might get added.
|
also 1.18 replay to old compression option will be good (for 1.16.1 replay watch)
|
Dakota_Fanning
Hungary2360 Posts
On May 23 2017 00:11 mca64Launcher_ wrote:
also 1.18 replay to old compression option will be good (for 1.16.1 replay watch)
I'm not sure just by repacking the data sections with the old compression would make replays watchable with old clients. There may be new commands/events which could crash old clients.
|
im pretty sure it will work, even if not its good to check this
|
Nice, will try it asap, thanks for your work!
|
I think you deserve a second star!
|
thanks, i can't seem to get it to work though
i cloned from git, installed go, and ran release.sh
[ol@localhost _release]$ ./release.sh
Using app folder: ../cmd/screp
Detected app name: screp
Detected app version: v1.0.0
Creating release screp-v1.0.0-linux-amd64.tar.gz...
../cmd/screp/screp.go:16:2: cannot find package "github.com/icza/screp/repparser" in any of:
/usr/lib/go/src/github.com/icza/screp/repparser (from $GOROOT)
/home/ol/go/src/github.com/icza/screp/repparser (from $GOPATH)
|
Dakota_Fanning
Hungary2360 Posts
On May 26 2017 00:47 Dead9 wrote:thanks, i can't seem to get it to work though i cloned from git, installed go, and ran release.sh [ol@localhost _release]$ ./release.sh
Using app folder: ../cmd/screp
Detected app name: screp
Detected app version: v1.0.0
Creating release screp-v1.0.0-linux-amd64.tar.gz...
../cmd/screp/screp.go:16:2: cannot find package "github.com/icza/screp/repparser" in any of:
/usr/lib/go/src/github.com/icza/screp/repparser (from $GOROOT)
/home/ol/go/src/github.com/icza/screp/repparser (from $GOPATH)
First let's clear some things. You do not need to checkout the source, and you do not need to install Go and build it yourself, because there are pre-built binaries on this page:
https://github.com/icza/screp/releases
Just download and use the one matching your platform.
Source code and custom build is only required if you want to build it for a platform not provided on the releases page. (Or if you want to modify the sources before building it, or if you want to use it as a library from your Go app.)
If you still want to build it: that is not how Go works. You need to setup a Go workspace, then easiest is to use "go get" to get the project (into your Go workspace) which also builds it. Or checkout the project with "git clone" into your already setup Go workspace, and then use "go install" or "go build" to build the screp executable. The "release.sh" is to build the packed release binaries you can download from the releases page.
For more information about how to setup a Go workspace and how to get started with Go:
How to Write Go Code
A Tour of Go
|
Thanks for the Linux client
|
I dont understand this but that does not mean I do not appreciate it. Thanks for all your hard work!
|
As a data analyst I find this to be absolutly amazing. Will definitely check out once I get home
|
On May 26 2017 02:25 Dakota_Fanning wrote:First let's clear some things. You do not need to checkout the source, and you do not need to install Go and build it yourself, because there are pre-built binaries on this page: https://github.com/icza/screp/releasesJust download and use the one matching your platform. Source code and custom build is only required if you want to build it for a platform not provided on the releases page. (Or if you want to modify the sources before building it, or if you want to use it as a library from your Go app.) If you still want to build it: that is not how Go works. You need to setup a Go workspace, then easiest is to use "go get" to get the project (into your Go workspace) which also builds it. Or checkout the project with "git clone" into your already setup Go workspace, and then use "go install" or "go build" to build the screp executable. The "release.sh" is to build the packed release binaries you can download from the releases page. For more information about how to setup a Go workspace and how to get started with Go: How to Write Go CodeA Tour of Go
ah i see, thanks!
|
Could you add a winner/loser field? I'm currently just walking backwards through the commands and finding the 'Defeat' event and that's fine, just a little quality of life thing.
|
Hey this looks great. I was looking for a tool to analyze rep files and this seems great.
Sorry for the noob question but how can I use this? I'm not super familiar with command line tools so could anyone link me with some tutorial or point in the right direction? Thanks!
|
Never cease to amaze with your great work Dakota_fanning, will you be releasing updated version of BWChart / the program you made in SC2 similar? (Can't remember the name for the life of me sorry)
|
Dakota_Fanning
Hungary2360 Posts
On May 31 2017 03:16 ldv wrote:
Could you add a winner/loser field? I'm currently just walking backwards through the commands and finding the 'Defeat' event and that's fine, just a little quality of life thing.
Yes, result is not part of the header, but it is available as a "Leave Game" command, which has a Reason field with possible values: Quit, Defeat, Victory, Finished, Draw, Dropped.
Adding this to the header is a nice improvement. Will do it if I won't forget about it (open an issue to make sure of it).
|
Dakota_Fanning
Hungary2360 Posts
On May 31 2017 03:49 Ubersturmfuhrer wrote:
Hey this looks great. I was looking for a tool to analyze rep files and this seems great.
Sorry for the noob question but how can I use this? I'm not super familiar with command line tools so could anyone link me with some tutorial or point in the right direction? Thanks!
You have to download the one that matches your operating system from here:
https://github.com/icza/screp/releases
It's a compressed file, extract it. Now you have a runnable app. Open a terminal / command line window, navigate to the folder you extracted it to, and type its name, and pass a replay file (with full path) to it.
For example:
screp myrep.rep
By default it will parse the replay and show you the replay header and nothing else.
If you also want to see basic map info (e.g. tile set, start locations of players etc.) and resource locations on the map (minerals and geysers), then type:
screp -map -mapres myrep.rep
To see a list of all available options, type:
screp -h
|
Dakota_Fanning
Hungary2360 Posts
On May 31 2017 03:51 GGzerG wrote:
Never cease to amaze with your great work Dakota_fanning, will you be releasing updated version of BWChart / the program you made in SC2 similar? (Can't remember the name for the life of me sorry)
I've made a few tools like BWHF Agent for SC:BW, Sc2gears and Sceilght for SC2.
And now screp (for SC:BW) and s2prot (for SC2).
And I'm planning / working on something new, something universal...
|
At first I thought it was spelled scgrep, missed opportunity:/
|
Dakota_Fanning
Hungary2360 Posts
|
This is amazing; thank you.
|
Dakota_Fanning
Hungary2360 Posts
|
Amazing tool, thanks for making it open source, we need more developers like you!
|
On May 26 2017 21:02 Neneu wrote:
As a data analyst I find this to be absolutly amazing. Will definitely check out once I get home
This is the exact reason I asked Dakota_Fanning to update it to support newer replays. I think this opens up a number of interesting data-science-related use cases. This is exciting!
|
|
|
Hey,
This isnt working for me. Not sure why. When i try to run it, i see a CMD prompt window pop up for a half second then nothing. Tried running as admin for the x86 and 64bit versions. I noticed it says AMD on the 64 bit one is it possible this just wont work on some intel systems (what i have)
thanks
|
Hi,
I can't find the OSX version for this app, can anyone send me the link?
|
Dakota_Fanning
Hungary2360 Posts
The latest release is v1.1.0. All binary releases including the OS-X release can be found on the v1.1.0 releases page:
https://github.com/icza/screp/releases/tag/v1.1.0
The 64-bit version is named screp-v1.1.0-darwin-amd64.tar.gz.
The 32-bit version is named screp-v1.1.0-darwin-386.tar.gz
|
Dakota_Fanning
Hungary2360 Posts
On April 12 2019 08:20 Scuzzzy wrote:
Hey,
This isnt working for me. Not sure why. When i try to run it, i see a CMD prompt window pop up for a half second then nothing. Tried running as admin for the x86 and 64bit versions. I noticed it says AMD on the 64 bit one is it possible this just wont work on some intel systems (what i have)
thanks
It runs on 64-bit Intel processors too, the "amd64" is the target architecture, the instruction set used to assemble the code, supported by both 64-bit Intel and AMD processors.
But this app does not have a GUI (graphical user interface). This is a command line tool. So you have to open a command line interpreter (e.g. cmd.exe on Windows), navigate to the folder you downloaded and extracted it, and type its name, e.g. "screp.exe".
Then you will see an info message about usage. To see all your options, type "screp -h".
In short, you have to pass the replay file you want to extract info out of, e.g. "screp myreplay.rep".
|
Thanks for the fast reply man.
Got it working now, very cool stuff.
|
|
|
|
|
|
|
|
EPT
