{"id":13523076,"url":"https://github.com/ilyakurdyukov/brickgame-4bit","last_synced_at":"2025-10-06T20:19:25.343Z","repository":{"id":213251580,"uuid":"733396628","full_name":"ilyakurdyukov/brickgame-4bit","owner":"ilyakurdyukov","description":"Brick Game emulator (4-bit Holtek chip), runs in a terminal","archived":false,"fork":false,"pushed_at":"2024-05-11T12:34:31.000Z","size":44,"stargazers_count":16,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-01T00:33:46.208Z","etag":null,"topics":["4-bit","brickgame","emulator","holtek"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ilyakurdyukov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-19T08:33:08.000Z","updated_at":"2025-03-07T17:38:27.000Z","dependencies_parsed_at":"2024-11-02T07:31:18.747Z","dependency_job_id":"db3ad7f7-b67d-454b-8be0-3cec364996ce","html_url":"https://github.com/ilyakurdyukov/brickgame-4bit","commit_stats":null,"previous_names":["ilyakurdyukov/brickgame-4bit"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ilyakurdyukov/brickgame-4bit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilyakurdyukov%2Fbrickgame-4bit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilyakurdyukov%2Fbrickgame-4bit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilyakurdyukov%2Fbrickgame-4bit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilyakurdyukov%2Fbrickgame-4bit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ilyakurdyukov","download_url":"https://codeload.github.com/ilyakurdyukov/brickgame-4bit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilyakurdyukov%2Fbrickgame-4bit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278672165,"owners_count":26025850,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["4-bit","brickgame","emulator","holtek"],"created_at":"2024-08-01T06:00:55.256Z","updated_at":"2025-10-06T20:19:25.328Z","avatar_url":"https://github.com/ilyakurdyukov.png","language":"C","funding_links":[],"categories":["Table of Contents","\u003ca name=\"games\"\u003e\u003c/a\u003eGames"],"sub_categories":[],"readme":"## Brick Game emulator\n\nThe emulator of a portable Brick Game console that uses a 4-bit microcontroller from Holtek.\n\nWorks only on Linux.\n\n### How to run the game\n\n1. Download the only known ROM dump [here](https://github.com/azya52/BrickEmuPy/blob/main/assets/E23PlusMarkII96in1.bin).\n\n2. Run `make` to compile.\n\n3. Now you can start the emulator:  \n`./brickgame --rom E23PlusMarkII96in1.bin`\n\n* Run `./brickgame --help` to show the configuation options.\n\n* Use `--save \u003cfilename\u003e` option to save game state on exit.\n\n* Sound is not supported. At the beginning of the level the game plays a melody (which you won't hear), mute the sound (M key) so you don't have to wait.\n\n* [Here](https://github.com/ilyakurdyukov/ida-holtek-4bit) is a disassembler module for IDA to explore the ROM.\n\n### Experimental decompiler mode\n\nDecompiles the ROM into C code. Not recommended.  \nSave states are incompatible with the emulator mode.\n\n```\n$ make DECOMPILED=1 ROMNAME=E23PlusMarkII96in1.bin\n$ ./brickgame --save bricksave.bin\n```\n\nMade for ROM code research.\n\n### Controls\n\n| Key(s)           | Action             |\n|------------------|--------------------|\n| Up/Space/W       | rotate             |\n| Left/A           | left               |\n| Down/S           | down               |\n| Right/D          | right              |\n| R                | reset              |\n| M                | mute               |\n| Escape           | exit               |\n| P/Enter          | start/pause        |\n| Tab              | memory map         |\n\n### Gamepad controls\n\n| Key(s)           | Action             |\n|------------------|--------------------|\n| Left Stick       | L/R/down/rotate    |\n| D-Pad            | L/R/down/rotate    |\n| A/B/X/Y          | rotate             |\n| L1/R1            | memory map         |\n| Select           | mute               |\n| Start            | start/pause        |\n| Mode             | reset              |\n\nCompile with `GAMEPAD=1` option to enable gamepad support.\n\n### \"Screenshots\"\n\nGame select screen:\n```\n      HI-SCORE              0\n\n/--------------------\\\n|                    |\n|                    | NEXT\n|                    |\n|      [][][]        |\n|    []      []      |\n|    []      []      |\n|    []      []      |\n|    []      []      | SPEED  0\n|    []      []      |\n|      [][][]        | LEVEL 12\n|                    |\n|    [][][][][]      |\n|    []              |\n|    [][][][]        |  ROTATE\n|            []      |\n|            []      |    --\u003e\n|    []      []      |\n|      [][][]        |\n|                    |\n|                    |\n\\--------------------/\n```\n\nTetris game:\n```\n         SCORE            1000\n\n/--------------------\\\n|                    |\n|                    | NEXT\n|                    |\n|                    | []\n|            [][]    | [][]\n|            [][]    |   []\n|                    |\n|                    | SPEED  0\n|                    |\n|                    | LEVEL  0\n|                    |\n|[][]                |\n|[][]  []            |\n|[][][][]            |  ROTATE\n|[][][][]  []  [][][]|\n|[][][][][][]  [][]  |    --\u003e\n|[][][][][]    [][][]|\n|[][][][][][]  [][][]|  PAUSE\n|[][][][][][][]  [][]|\n|[][][][][][]  [][][]|\n\\--------------------/\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filyakurdyukov%2Fbrickgame-4bit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Filyakurdyukov%2Fbrickgame-4bit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filyakurdyukov%2Fbrickgame-4bit/lists"}