• Log InLog In
  • Register
Liquid`
Team Liquid Liquipedia
EST 15:59
CET 21:59
KST 05:59
  • 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
Potentially helpful Shield Battery feedback. People still play BW? List of top players active on ShieldBattery SC4ALL: II Indiegogo Campaign Announcement XUN appreciation thread
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
US Politics Mega-thread Russo-Ukrainian War 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: 14951 users

s2prot: Command line app to parse SC2Replay files

Forum Index > SC2 General
Post a Reply
Dakota_Fanning *
Profile Joined January 2008
Hungary2371 Posts
Last Edited: 2017-05-22 15:05:31
May 22 2017 14:29 GMT
#1
I've created and open-sourced a command line StarCraft II replay parser tool called s2prot here:

https://github.com/icza/s2prot

What it is

It's a standalone app with no GUI, and it can be used from the command line to pass a StarCraft II replay file to it (.SC2Replay), 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. s2prot 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 all versions (up to 3.14) that were written with retail versions of StarCraft II (and some beta versions too).

Download

Pre-built binaries can be downloaded from:

https://github.com/icza/s2prot/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/s2prot/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: Brood War replays: screp
https://repmastered.icza.net
feardragon
Profile Blog Joined October 2010
United States973 Posts
May 22 2017 15:30 GMT
#2
Yessss! Thank you for this. This is the push I needed to start playing around with replays more.
Ok Starcraft 2 Commentator
loginn
Profile Blog Joined January 2011
France815 Posts
May 22 2017 17:58 GMT
#3
Is this mainly a port of the s2protocol in Go ?
Loading a bunch of replays and processing them concurrently is very nice in any case.
Nice job
Stephano, Taking skill to the bank since IPL3. Also Lucifron and FBH
Dakota_Fanning *
Profile Joined January 2008
Hungary2371 Posts
Last Edited: 2017-05-22 18:04:37
May 22 2017 18:02 GMT
#4
On May 23 2017 02:58 loginn wrote:
Is this mainly a port of the s2protocol in Go ?
Loading a bunch of replays and processing them concurrently is very nice in any case.
Nice job

Yes, it is based on s2protocol, but everything is written in Go (s2protocol requires python). I also wrote the MPQ parser required by s2protocol in Go, made available as a separate open-source project: https://github.com/icza/mpq
https://repmastered.icza.net
Haighstrom
Profile Joined March 2011
United Kingdom217 Posts
May 22 2017 18:27 GMT
#5
Is the format spec for the replay files publicly available? I'm interested in developing my own parsing tool in C#.
Dakota_Fanning *
Profile Joined January 2008
Hungary2371 Posts
May 22 2017 19:33 GMT
#6
On May 23 2017 03:27 Haighstrom wrote:
Is the format spec for the replay files publicly available? I'm interested in developing my own parsing tool in C#.

There is no public doc available, the closest you can get is the s2protocol reference implementation.
https://repmastered.icza.net
FightingFrog
Profile Blog Joined September 2013
Sweden31 Posts
July 18 2017 15:29 GMT
#7
Hi again,

Thank you for redirecting me here from Scelight thread, this is exactly what I wanted!

I have a few questions:

1. Is there any information that that will allow me to distinguish between two players with identical name? If not, do you know if that information even exist in the replay?

2. Is it possible to see when units take damage/use spells/location at a given time? (other than when they are created/destroyed)
Dakota_Fanning *
Profile Joined January 2008
Hungary2371 Posts
July 19 2017 08:22 GMT
#8
On July 19 2017 00:29 FightingFrog wrote:
Hi again,

Thank you for redirecting me here from Scelight thread, this is exactly what I wanted!

I have a few questions:

1. Is there any information that that will allow me to distinguish between two players with identical name? If not, do you know if that information even exist in the replay?

2. Is it possible to see when units take damage/use spells/location at a given time? (other than when they are created/destroyed)

1. There is a universally unique identifier for all players, this is called the toon. The toon is recorded in multiple parts of the replay, for example in the Details section, Players array, Toon field. It contains the program ID ("S2" for StarCraft II), region ID, realm ID, and player ID.

2. Units taking damage is not recorded. Spell usage and location is recorded, this is in the Game events section.
https://repmastered.icza.net
Dakota_Fanning *
Profile Joined January 2008
Hungary2371 Posts
July 19 2017 08:38 GMT
#9
Btw I just released a new version v1.1.0 of s2prot, please do download the new version if you plan to play / experiment with it. It also adds support for replays up to 3.16.

New v1.1.0 version available for downloading here:

https://github.com/icza/s2prot/releases/tag/v1.1.0
https://repmastered.icza.net
Please log in or register to reply.
Live Events Refresh
BSL
05:00
S23 - Ro16 Group B
eOnzErG vs StRyKeR
Cross vs JDConan
ZZZero.O301
LiquipediaDiscussion
[ Submit Event ]
Live Streams
Refresh
StarCraft 2
JuggernautJason92
EmSc Tv 23
StarCraft: Brood War
Leta 774
Shuttle 400
ZZZero.O 269
firebathero 66
zelot 12
Terrorterran 3
Dota 2
Gorgc7538
BananaSlamJamma171
League of Legends
Trikslyr63
goblin9
Counter-Strike
gobbtv286
Heroes of the Storm
Liquid`Hasu503
Khaldor295
Other Games
tarik_tv4224
Grubby2289
FrodaN1466
B2W.Neo777
ScreaM749
C9.Mang0147
UpATreeSC43
Organizations
Other Games
gamesdonequick1024
StarCraft 2
EmSc Tv 23
angryscii 16
[ Show 16 non-featured ]
StarCraft 2
• printf 106
• Adnapsc2 15
• AfreecaTV YouTube
• intothetv
• Kozan
• IndyKCrew
• Migwel
StarCraft: Brood War
• Pr0nogo 5
• BSLYoutube
• STPLYoutube
• ZZZeroYoutube
Dota 2
• WagamamaTV480
Other Games
• imaqtpie1062
• Scarra494
• Shiphtur387
• tFFMrPink 17
Upcoming Events
RSL Revival
16h 1m
Clem vs Serral
herO vs Rogue
OSC
16h 1m
IPSL
20h 1m
Ret vs ggnore13
nOmaD vs Aether
BSL
23h 1m
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.