Replay format for Hearthstone
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Add CC0 LICENSE text Nov 14, 2015 Update May 17, 2018
hsreplay.dtd Release 1.8 Nov 29, 2018


HSReplay is a replay format for Hearthstone.

It is an XML-based format, with a structure closely mirroring that of the game's protocol.

The extension for HSReplay files is .hsreplay. The MIME Type is application/vnd.hearthsim-hsreplay+xml.


Spec docs are available here.

Documentation for the Hearthstone Gamestate Protocol, which HSReplay mirrors, is available here.


There is currently only one official implementation of the HSReplay format:

If you are interested in developing reference implementations in other languages, please get in touch by filing an issue!


The HSReplay spec is licensed CC0. This puts it in the public domain. The full license text is available in the LICENSE file.


HSReplay is a HearthSim project. Join the community: