{"id":20777348,"url":"https://github.com/georgjz/atari-st-project-template","last_synced_at":"2026-02-21T22:06:22.840Z","repository":{"id":129682534,"uuid":"229440887","full_name":"georgjz/atari-st-project-template","owner":"georgjz","description":"A simple project template for Atari ST programming in assembly","archived":false,"fork":false,"pushed_at":"2019-12-21T15:16:17.000Z","size":12,"stargazers_count":6,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-30T18:35:46.366Z","etag":null,"topics":["68k-assembly","atari-st","motorola-68000"],"latest_commit_sha":null,"homepage":null,"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/georgjz.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,"zenodo":null}},"created_at":"2019-12-21T14:43:14.000Z","updated_at":"2025-02-22T01:06:16.000Z","dependencies_parsed_at":"2023-03-13T11:19:58.840Z","dependency_job_id":null,"html_url":"https://github.com/georgjz/atari-st-project-template","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/georgjz/atari-st-project-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/georgjz%2Fatari-st-project-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/georgjz%2Fatari-st-project-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/georgjz%2Fatari-st-project-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/georgjz%2Fatari-st-project-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/georgjz","download_url":"https://codeload.github.com/georgjz/atari-st-project-template/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/georgjz%2Fatari-st-project-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29694857,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T18:18:25.093Z","status":"ssl_error","status_checked_at":"2026-02-21T18:18:22.435Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["68k-assembly","atari-st","motorola-68000"],"created_at":"2024-11-17T13:15:01.595Z","updated_at":"2026-02-21T22:06:22.808Z","avatar_url":"https://github.com/georgjz.png","language":"Assembly","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple Atari ST Project Template\n\nThis is a simple project template for assembly programming projects for cross-developing for the Atari ST. You'll need [make][3], [vasm][1], and [vlink][2] installed for it to work. Check your distribution's package manager.\n\nThe example code in this repository loads a palette into VDP and displays a simple sprite. Then it enters an endless loop.\n\nI prefer to assemble files into object files first and link them into an executable/ROM in a separate step. So the Makefile in this repository uses both the [vasm assembler][1] and [vlink linker][2].\n\n## Usage \n\nUse git to clone this repository:\n\n```bash\ngit clone https://github.com/georgjz/atari-st-project-template\ncd atari-st-project-template\nmake\n```\n\nThe makefile will look for all source files ending with `*.s` in the directory `src/` and all its subdirectories. Include files ending with `*.inc` will automatically added to the assembler arguments with `-I`. These files are translated into object files and listings will be placed in the directory `obj/`. Finally, the linker will build the final executable and place it in `build/`.\n\n### Switching between Syntax Standards\n\nI prefer vasm's [Motorola Syntax][4]; if you wish to use another syntax, you'll need to modify line 20 in the Makefile.\n\n**WARNING**: Switching to another syntax/assembler might break the example code given here.\n\n## Example Code \n\nThere's two source files in `src/`:\n- `init.s` contains the code that GEMDOS requires the program to execute. It will calculate its own size, and uses [`Mshrink`][8] to shrink the TPA to the correct size. It then jumps to the `Main` routine.\n- `main.s` contains the `Main` routine. It switches to supervisor mode. Then it waits for the space key to be pressed. Once space it pressed, it calls [`Pterm`][9] to exit the program and return to TOS. It also contains the bss definition for the user stack.\n\n## License \n\nAll code in this repository is under the [MIT license][6].\n\n[1]: http://sun.hasenbraten.de/vasm/\n[2]: http://sun.hasenbraten.de/vlink/\n[3]: https://www.gnu.org/software/make/\n[4]: http://sun.hasenbraten.de/vasm/release/vasm.html\n[5]: https://www.reaktor.com/blog/crash-course-to-amiga-assembly-programming/\n[6]: https://opensource.org/licenses/MIT\n[7]: https://darkdust.net/writings/megadrive/initializing\n[8]: https://freemint.github.io/tos.hyp/en/gemdos_memory.html#Mshrink\n[9]: https://freemint.github.io/tos.hyp/en/gemdos_process.html#Pterm","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeorgjz%2Fatari-st-project-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeorgjz%2Fatari-st-project-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeorgjz%2Fatari-st-project-template/lists"}