{"id":23661381,"url":"https://github.com/city41/ereader-solitaire","last_synced_at":"2025-08-23T00:27:39.164Z","repository":{"id":269306863,"uuid":"906995756","full_name":"city41/ereader-solitaire","owner":"city41","description":"Solitaire for the Nintendo E-Reader","archived":false,"fork":false,"pushed_at":"2025-06-13T14:28:25.000Z","size":502,"stargazers_count":13,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-06T09:02:20.150Z","etag":null,"topics":["ereader","gba","homebrew","nintendo","retrodev","retrogaming","z80"],"latest_commit_sha":null,"homepage":"","language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/city41.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-12-22T14:22:42.000Z","updated_at":"2025-06-25T14:35:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"5ee8352a-da53-4ab5-9e67-b42492524572","html_url":"https://github.com/city41/ereader-solitaire","commit_stats":null,"previous_names":["city41/ereader-solitaire"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/city41/ereader-solitaire","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/city41%2Fereader-solitaire","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/city41%2Fereader-solitaire/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/city41%2Fereader-solitaire/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/city41%2Fereader-solitaire/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/city41","download_url":"https://codeload.github.com/city41/ereader-solitaire/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/city41%2Fereader-solitaire/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271723042,"owners_count":24809670,"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-08-22T02:00:08.480Z","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":["ereader","gba","homebrew","nintendo","retrodev","retrogaming","z80"],"created_at":"2024-12-29T04:57:30.747Z","updated_at":"2025-08-23T00:27:39.155Z","avatar_url":"https://github.com/city41.png","language":"Assembly","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Solitaire for the Nintendo E-Reader\n\nThis is the classic game of solitaire for the Nintendo E-Reader. It is written as an E-Reader z80 application.\n\n![screenshot](https://github.com/city41/ereader-solitaire/blob/main/screenshot_2x.png?raw=true)\n\nThis is the first z80/ereader app I wrote, and so the code is pretty bad in places, and the build process is also pretty bad. I will eventually come back and modernize it.\n\n## To build\n\nOnly tested on Ubuntu 22. It should \"just work\" on Ubuntu and other Linuxes\n\n```bash\ncd src\nmake clean \u0026\u0026 make sav\n```\n\nThis will create `src/solitaire.sav` which can be loaded into an emulator or flash card along with the ereader ROM.\n\n![running the sav](https://github.com/city41/ereader-solitaire/blob/main/runningSav.png?raw=true)\n\n## Running in mGBA\n\nAs long as `mgba` is in your path, then `make clean \u0026\u0026 make runsav` should build the game then immediately launch it in mGBA. This requires the ereader ROM to be where the Makefile expects it. Look for `EREADER_MGBA_ROM` in the Makefile.\n\n## Creating raws and bmps\n\nTo create raws, you will need wine installed. That is because the linux version of nedcmake has a bug and usually crashes.\n\n`make raws` will build the `.raw` files that can then be loaded into an emulator or converted into bitmaps for printing.\n\n`make bmps` will directly make the bmps for you, no need to muck with raws. You can set DPI too, `make DPI=600 bmps`, the default is 1200.\n\n## Building on other OSes\n\nI have never tested this. But basically you will need to get the proper ereader tools, place them in `bin/`, and then update the Makefile accordingly.\n\nA modern port of the tools can be found here: https://github.com/breadbored/nedclib\n\nThe original tools for Windows can be found here: https://caitsith2.com/ereader/devtools.htm\n\n## Changing the graphics\n\nYou will need nodejs for this. Make sure you run `yarn` at the root of the repo to get all the node modules.\n\nChange the graphics in the `src/resources/` as you see fit. Then run `make gfx`. If you add frames of animation, `resources/resources.json` will need to be updated, as will the sprite definitions in the code.\n\nThe graphics are built using `src/convertpng`, a very simple png to gba graphics tool I made. I hope to one day make it full featured and release it on its own.\n\n## The assembler\n\nI wrote this using [asz80](https://shop-pdp.net/ashtml/asz80.htm) which is a very old, but pretty good, z80 assembler. It's main gotcha is it doesn't directly produce a binary. If you look in the Makefile, you will see asm-\u003ebin is several steps.\n\nYou can get asz80 binaries here: https://shop-pdp.net/ashtml/asxget.php\n\n## Japanese support\n\nSolitaire runs as-is on the Japanese E-Reader+. It has no text, and is completely compatible.\n\nTo build for Japanese: `make REGION=2 raws` or `make REGION=2 bmps`. `REGION=2` is not needed when building the sav file, as no region checking is done with sav files.\n\nTo run it in mGBA on the Japanese ereader ROM, `make runsavjpn`. With the sav file approach, there is no region checking. It will appear garbeled in the ereader menu, but other than that work just fine. You need to have the Japanese ereader ROM where the Makefile expects it. Check the Makefile for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcity41%2Fereader-solitaire","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcity41%2Fereader-solitaire","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcity41%2Fereader-solitaire/lists"}