{"id":15048996,"url":"https://github.com/joegasewicz/zx80-dev-tools","last_synced_at":"2025-04-10T01:40:57.804Z","repository":{"id":230629436,"uuid":"779841823","full_name":"joegasewicz/zx80-dev-tools","owner":"joegasewicz","description":"ZX Spectrum NEXT development tools for MacOS","archived":false,"fork":false,"pushed_at":"2025-04-09T14:32:43.000Z","size":12213,"stargazers_count":13,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-09T15:22:24.153Z","etag":null,"topics":["c-language","m1","m2","macos","next-basic","z80-assembly","zx-spectrum-next","zx80"],"latest_commit_sha":null,"homepage":"","language":"Makefile","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/joegasewicz.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":"2024-03-30T23:40:06.000Z","updated_at":"2025-04-09T14:32:46.000Z","dependencies_parsed_at":"2024-10-12T17:03:49.907Z","dependency_job_id":"7dab6b87-cb52-4a32-907a-42af608a1fc6","html_url":"https://github.com/joegasewicz/zx80-dev-tools","commit_stats":null,"previous_names":["joegasewicz/zx80-dev-tools"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joegasewicz%2Fzx80-dev-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joegasewicz%2Fzx80-dev-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joegasewicz%2Fzx80-dev-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joegasewicz%2Fzx80-dev-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joegasewicz","download_url":"https://codeload.github.com/joegasewicz/zx80-dev-tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248142050,"owners_count":21054576,"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","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":["c-language","m1","m2","macos","next-basic","z80-assembly","zx-spectrum-next","zx80"],"created_at":"2024-09-24T21:17:30.744Z","updated_at":"2025-04-10T01:40:57.783Z","avatar_url":"https://github.com/joegasewicz.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Z80 MacOS Starter Template\nZX80 NEXT development tools for MacOS\n\n![Alt Text](images/example2.gif)\n\n\n### Install Requirements\nYou must have virtualenv installed, if not run `brew install virtualenv`\nTo install the compilers \u0026 emulator run the following:\n\n*(You will be prompted to input your user password)*\n```\nmake install  # and follow the installation instructions\n```\n\n### Installs the following requirements\n1. Download [Z88DK](https://github.com/z88dk/z88dk/releases)\n2. Download [Zesarux](https://github.com/chernandezba/zesarux/releases/tag/ZEsarUX-X)\n3. Download [sjasmplus](https://github.com/z00m128/sjasmplus/blob/master/INSTALL.md#default-method-for-gnulinux--unix--macos--bsd)\n4. Fuse\n\n### Using C Language\nPlace code in the `main.c` file \u0026 use the following command to compile \u0026\nruns the output .tap file in the Fuse emulator.\n```\nmake build\n```\n\n### Using Z80 Assembly\nPlace your Assembly code in the `src` directory.\nYou can run each individual step to assemble with:\n```\nmake clean\nmake assemble\nmake run_snapshot\n```\nOr use a single command to run all the above:\n```\nmake run_assembly\n```\nThis will assemble your code \u0026 open the Zesarux emulator \u0026\nrun the compiled snapshot.\n\n### Using NEXT Basic\nPlace your NEXT Basic code in the `basic` directory.\nYou can run each individual step to create a `.tap` file with:\n```\nmake clean_tap\nmake bas_to_tap\nmake run_tap:\n```\nOr use a single command to run all the above:\n```\nmake run_basic:\n```\nThis will create a `.tap` file from your NEXT Basic code \u0026 open the Zesarux emulator.\nCurrently, it only loads the output `.tap` file, You will have to load the file manually\nwithin the Zesarux emulator.\n\n### CSpect\nTo get CSpect running on MacOS with an M1, M2 chip you will need to follow\nthese steps:\n1. Download [ITerm2](https://iterm2.com/downloads.html)\n2. Goto Applications, \n   - Right click on Iterm2 \u0026 click `Duplicate`.\n   - Rename to `Iterm2 x86_64`\n   - Still in Applciations folder, Left click on the `Iterm2 x86_64` icon \u0026 select `Get Info` \u0026 check the *Open using Rosetta* option.\n   - Now open the Iterm2 x86_64 terminal\n3. Install Rosetta - `softwareupdate --install-rosetta`\n4. Install brew (this will install a new version of brew to `/usr/local`)\n5. Install Mono - `arch -x86_64 brew install mono`\n6. Download [CSpect](https://mdf200.itch.io/cspect)\n7. You will also need a ZX Spectrum NEXT image [here](https://zxspectrumnext.online/cspect/)\n    - Select an image from **CURRENT DISTRO IMAGES** section.\n    - Place this image in your CSpect root folder.\n8. Run CSpect `mono cspect.exe -zxnext -nextrom -mmc=cspect-next-2gb.img`\n\n### Run CSpect\nOnce you have the followed the above steps, you can now use the following commands\n\n#### Run CSpect\n```\nsh cspect.sh\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoegasewicz%2Fzx80-dev-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoegasewicz%2Fzx80-dev-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoegasewicz%2Fzx80-dev-tools/lists"}