bin+lib bitsy-parser

A parser and utilities for working with Bitsy game data

28 releases

0.72.3 Oct 9, 2020
0.72.1 Sep 25, 2020
0.71.7 Jul 26, 2020

#63 in Game dev

Download history 44/week @ 2020-06-27 21/week @ 2020-07-04 18/week @ 2020-07-11 98/week @ 2020-07-18 42/week @ 2020-07-25 2/week @ 2020-08-01 29/week @ 2020-08-08 83/week @ 2020-08-15 1/week @ 2020-08-22 26/week @ 2020-08-29 75/week @ 2020-09-05 10/week @ 2020-09-19 9/week @ 2020-09-26 45/week @ 2020-10-03 7/week @ 2020-10-10

141 downloads per month

MIT license




Bitsy is a small game editor created by Adam Le Doux. this crate provides a library and command-line utilities for working with Bitsy game data. the version number follows Bitsy itself, so version 0.70.* targets Bitsy 7.0.

bitsy-parser is minimally invasive; unless you make any changes, an exported game should be identical to the imported game. however, this assumes your game data is valid. most minor errors will simply be corrected on import (e.g. extraneous tiles in a room) but bigger problems may cause bitsy-parser to crash or fail.

I have tested bitsy-parser on a dataset of over 1500 Bitsy games ranging from Bitsy 1.0 to Bitsy 7.1 and have found that the vast majority of games can be imported without any problems. so, I can almost guarantee that a Bitsy game will not be mangled by the parser, but I still recommend making backups of your game data periodically.


this crate provides some command-line tools for working with Bitsy game data.

  • bitsy-dedupe
  • bitsy-merge
  • bitsy-validate

the source for these can be found in src/bin. if you have Cargo installed, you can install/update these utilities with cargo install --force bitsy-parser. if your .cargo/bin directory is in your PATH, you will be able to use these utilities anywhere on your computer.


for use in your own Rust applications. can both parse and export Bitsy game data.

a simple example program:

use bitsy_parser::Game;
use std::{env, fs};

const SYNTAX_ERROR: &str = "No input path specified. Usage: `bitsy-validate filepath`";

fn main() {
    let input = env::args().nth(1).expect(SYNTAX_ERROR);

some more practical uses would be things like:

  • convert images or other file formats to Bitsy assets
  • programmatically create Bitsy games
  • a Bitsy game editor