• Log InLog In
  • Register
Liquid`
Team Liquid Liquipedia
EST 15:35
CET 21:35
KST 05:35
  • Home
  • Forum
  • Calendar
  • Streams
  • Liquipedia
  • Features
  • Store
  • EPT
  • TL+
  • StarCraft 2
  • Brood War
  • Smash
  • Heroes
  • Counter-Strike
  • Overwatch
  • Liquibet
  • Fantasy StarCraft
  • TLPD
  • StarCraft 2
  • Brood War
  • Blogs
Forum Sidebar
Events/Features
News
Featured News
Team Liquid Map Contest #2312[ASL22] Finals Preview: Sweet Victory!12[ASL22] Ro4 Preview: Mirror Mirror6[ASL22] Ro8 Preview: Within Reach5[ASL22] Ro8 Preview: In A Tizzy11
Community News
Weekly Cups (Nov 9-15): Clem and herO take over6Dark completes military service, returns to SC217[BSL23] RO16 Group Stage20Weekly Cups (Nov 2-8): herO back on top?2Weekly Cups (Oct 26 - Nov 1): MaxPax, herO, Solar win0
StarCraft 2
General
Weekly Cups (Nov 9-15): Clem and herO take over SC4ALL: II Indiegogo Campaign Announcement No more SC2 streamers on team liquid? Team Liquid Map Contest #23 StarCraft open world shooter announced at BlizzCon
Tourneys
RSL goes to London! 2026 Offline Finals Nov 21-22 soO & FanTaSy return! SC2 Kevin Scrim 4v4 (Nov 16) Sparkling Tuna Cup - Weekly Open Tournament Sea Duckling Open (Global, Bronze-Diamond) Dark returns! GSL CK #7 4v4 Team Battle (Nov 19)
Strategy
[H] ZvP Mid-Late Game: Stalkers Collossi HT
Custom Maps
[G] How to playtest arcade maps Starcraft 2 Advance [D] the control group Simple Questions/Answers
External Content
Mutation # 552 Secret Storm The PondCast: SC2 News & Results Mutation # 551 Robotic Revival Mutation # 550 Graveyard Shift
Brood War
General
People still play BW? List of top players active on ShieldBattery SC4ALL: II Indiegogo Campaign Announcement XUN appreciation thread Shield Battery Server New Patch
Tourneys
2v2v2v2 Tournament Stage 2: Players [BSL23] Ro16 Group B - Saturday 21:00 CET KCM Race Survival 2026 Season 4 SC1 Kevin Scrim hosted by SOOP (Nov 18-19)
Strategy
Pluto's TvP 5Marine 2Medic Push Simple Questions, Simple Answers Infested Terran strategies in 2026 Nuke strategy worked in K-League 2026-11-09
Other Games
General Games
The PlayStation 5 Nintendo Switch Thread Stormgate/Frost Giant Megathread Warcraft III: The Frozen Throne Free Space RTS Game, optimised f. Phone/Tablet etc
Dota 2
League of Legends
[TL LoL EUW IHs] Teemo shall perish
Heroes of the Storm
Heroes of the Storm 2.0
Hearthstone
Deck construction bug
TL Mafia
TL Mafia Community Thread
Community
General
Russo-Ukrainian War Thread US Politics Mega-thread Trading/Investing Thread Artificial Intelligence Thread The Big Programming Thread
Fan Clubs
Fan Club Resource Thread Reynor Fan Club The Flash Fan Club
Media & Entertainment
Movie Discussion! Anime Discussion Thread [Manga] One Piece
Sports
Football (Soccer) Thread TeamLiquid Health and Fitness Initiative For 2023
World Cup 2022
Tech Support
Computer Build, Upgrade & Buying Resource Thread
TL Community
The Automated Ban List Recent Gifted Posts
Blogs
The time I organised my…
AssyrianKing
Why I built Repalyzer (1.1.…
BlueStar
Innovate or Game Over?
TrAiDoS
ShieldBattery on Mac
Kraekkling
Can Bots Beat Pros?? Starcr…
namkraft
James Bond movies ranking - pa…
Topin
StarCraft improvement
iopq
Customize Sidebar...

Website Feedback

Closed Threads



Active: 14275 users

screp: Command line app to parse SC rep files

Forum Index > BW General
Post a Reply
1 2 Next All
Dakota_Fanning *
Profile Joined January 2008
Hungary2371 Posts
Last Edited: 2017-05-22 15:05:34
May 22 2017 14:29 GMT
#1
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
https://repmastered.icza.net
mca64Launcher_
Profile Joined June 2015
Poland629 Posts
May 22 2017 14:56 GMT
#2
thx, gonna use it unless it requires additional shit
mca64Launcher_
Profile Joined June 2015
Poland629 Posts
May 22 2017 14:57 GMT
#3
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 *
Profile Joined January 2008
Hungary2371 Posts
May 22 2017 15:03 GMT
#4
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.
https://repmastered.icza.net
mca64Launcher_
Profile Joined June 2015
Poland629 Posts
May 22 2017 15:11 GMT
#5
also 1.18 replay to old compression option will be good (for 1.16.1 replay watch)
Dakota_Fanning *
Profile Joined January 2008
Hungary2371 Posts
May 22 2017 15:15 GMT
#6
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.
https://repmastered.icza.net
mca64Launcher_
Profile Joined June 2015
Poland629 Posts
May 22 2017 15:21 GMT
#7
im pretty sure it will work, even if not its good to check this
Glioburd
Profile Joined April 2008
France1911 Posts
May 22 2017 15:43 GMT
#8
Nice, will try it asap, thanks for your work!
"You should hate loosing, but you should never fear defeat." NaDa.
DarkNetHunter
Profile Joined October 2012
1224 Posts
May 22 2017 20:48 GMT
#9
I think you deserve a second star!

Learn from the mistakes of others. You can't live long enough to make them all yourself.
Dead9
Profile Blog Joined February 2008
United States4725 Posts
May 25 2017 15:47 GMT
#10
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 *
Profile Joined January 2008
Hungary2371 Posts
Last Edited: 2017-05-26 12:02:06
May 25 2017 17:25 GMT
#11
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
https://repmastered.icza.net
Thyriaen
Profile Joined December 2011
Switzerland41 Posts
Last Edited: 2017-05-25 21:17:36
May 25 2017 21:16 GMT
#12
Thanks for the Linux client
Psyonic_Reaver
Profile Blog Joined June 2007
United States4343 Posts
May 25 2017 22:26 GMT
#13
I dont understand this but that does not mean I do not appreciate it. Thanks for all your hard work!
So wait? I'm bad? =(
Neneu
Profile Joined September 2010
Norway492 Posts
Last Edited: 2017-05-26 12:04:26
May 26 2017 12:02 GMT
#14
As a data analyst I find this to be absolutly amazing. Will definitely check out once I get home
Dead9
Profile Blog Joined February 2008
United States4725 Posts
May 26 2017 20:24 GMT
#15
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/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

ah i see, thanks!
ldv
Profile Blog Joined April 2017
United States103 Posts
May 30 2017 18:16 GMT
#16
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.
Ubersturmfuhrer
Profile Joined May 2008
Finland206 Posts
May 30 2017 18:49 GMT
#17
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 will not be punished for your anger, you will be punished by your anger
TelecoM
Profile Blog Joined January 2010
United States10900 Posts
May 30 2017 18:51 GMT
#18
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)
AKA: TelecoM[WHITE] Protoss fighting
Dakota_Fanning *
Profile Joined January 2008
Hungary2371 Posts
May 30 2017 19:13 GMT
#19
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).
https://repmastered.icza.net
Dakota_Fanning *
Profile Joined January 2008
Hungary2371 Posts
Last Edited: 2017-05-30 19:19:21
May 30 2017 19:17 GMT
#20
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
https://repmastered.icza.net
1 2 Next All
Please log in or register to reply.
Live Events Refresh
BSL
05:00
S23 - Ro16 Group B
eOnzErG vs StRyKeR
Cross vs JDConan
ZZZero.O167
LiquipediaDiscussion
[ Submit Event ]
Live Streams
Refresh
StarCraft 2
JuggernautJason97
EmSc Tv 24
StarCraft: Brood War
Leta 732
Shuttle 416
ZZZero.O 167
Dewaltoss 155
firebathero 77
zelot 12
Terrorterran 2
Dota 2
Gorgc7562
BananaSlamJamma182
League of Legends
Trikslyr62
goblin11
Counter-Strike
gobbtv337
Heroes of the Storm
Liquid`Hasu467
Khaldor303
Other Games
tarik_tv4795
Grubby1991
FrodaN1116
ScreaM814
B2W.Neo792
C9.Mang0168
UpATreeSC41
Organizations
Other Games
gamesdonequick972
BasetradeTV138
StarCraft 2
EmSc Tv 24
angryscii 15
[ Show 18 non-featured ]
StarCraft 2
• printf 99
• Adnapsc2 10
• AfreecaTV YouTube
• intothetv
• Kozan
• IndyKCrew
• Migwel
StarCraft: Brood War
• Airneanach75
• 80smullet 18
• Pr0nogo 4
• BSLYoutube
• STPLYoutube
• ZZZeroYoutube
Dota 2
• WagamamaTV409
Other Games
• imaqtpie893
• Scarra502
• Shiphtur382
• tFFMrPink 15
Upcoming Events
RSL Revival
16h 26m
Clem vs Serral
herO vs Rogue
OSC
16h 26m
IPSL
20h 26m
Ret vs ggnore13
nOmaD vs Aether
BSL
23h 26m
Bonyth vs Doodle
Kyrie vs Jimin
Replay Cast
1d 2h
WardiTV Weekly
1d 15h
Kung Fu Cup
2 days
Solar vs Classic
ByuN vs SHIN
PiGosaur Cup
3 days
The PondCast
4 days
KCM Race Survival
4 days
Liquipedia Results

Completed

Proleague 2026-11-17
Blizzard Classic Cup 2026
HCC Season 3

Ongoing

Acropolis #5
KCM Race Survival 2026 Season 4
International ShieldBattery League
BSL Season 23
IPSL Winter 2026-27
RSL Offline Finals
Calamity Cup Div. A Season 8
Underdog Cup 2026 Div 2-3
Stake Ranked Episode 6
BLAST Rivals Fall 2026
IEM Beijing 2026
PGL Masters Bucharest 2026
Stake Ranked Episode 5
1win Private Club #2
Thunderpick World Champ. '26
ESL Pro League Season 24
Stake Ranked Episode 4
1win Private Club #1
Logitech G Play Connect 2026
SL StarSeries Fall 2026
FISSURE Playground #3

Upcoming

CSL Season 23: Qualifier 1
Sector 591
YSL S4
SC4ALL II: Brood War
CSL 2026 Winter (S23) - 3v3
CSL 2026 Winter (S23)
NBSL 2026 Xiamen LAN
HSC XXX
Stellar Fest 2: Lunar Cup
StarCraft2 Weekly Open Tournament 2026 Grand Finals
SC4ALL II: StarCraft II
Kung Fu Cup 2026 Grand Finals
IEM Kraków 2027
PGL Bucharest 2027
BLAST Bounty Winter 2027
PGL Major Singapore 2026
TLPD

1. ByuN
2. TY
3. Dark
4. Solar
5. Stats
6. Nerchio
7. sOs
8. soO
9. INnoVation
10. Elazer
1. Rain
2. Flash
3. EffOrt
4. Last
5. Bisu
6. Soulkey
7. Mini
8. Sharp
Sidebar Settings...

Advertising | Privacy Policy | Terms Of Use | Contact Us

Original banner artwork: Jim Warren
The contents of this webpage are copyright © 2026 TLnet. All Rights Reserved.