{"id":15489323,"url":"https://github.com/stefanschramm/retroload","last_synced_at":"2025-04-22T18:20:01.275Z","repository":{"id":65385238,"uuid":"588498614","full_name":"stefanschramm/retroload","owner":"stefanschramm","description":"RetroLoad.com is a web application for converting tape archive files of historical computers into sound.","archived":false,"fork":false,"pushed_at":"2023-12-19T22:28:44.000Z","size":953,"stargazers_count":3,"open_issues_count":15,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2023-12-20T13:07:03.867Z","etag":null,"topics":["6502","6510","8bit-computers","acorn-electron","assembly","atari800","c64","cpc464","hello-world","kc85","lc80","msx","retrocomputing","retrogaming","tape-archive","ti994a","vic20","vintage-computers","z1013","z80"],"latest_commit_sha":null,"homepage":"https://retroload.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stefanschramm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"custom":"https://github.com/stefanschramm/retroload/issues?q=is%3Aissue+is%3Aopen+label%3A%22hardware+donation+request%22"}},"created_at":"2023-01-13T09:10:57.000Z","updated_at":"2023-12-25T11:26:26.824Z","dependencies_parsed_at":"2023-12-25T11:26:22.521Z","dependency_job_id":null,"html_url":"https://github.com/stefanschramm/retroload","commit_stats":null,"previous_names":[],"tags_count":11,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanschramm%2Fretroload","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanschramm%2Fretroload/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanschramm%2Fretroload/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanschramm%2Fretroload/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stefanschramm","download_url":"https://codeload.github.com/stefanschramm/retroload/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250296451,"owners_count":21407037,"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":["6502","6510","8bit-computers","acorn-electron","assembly","atari800","c64","cpc464","hello-world","kc85","lc80","msx","retrocomputing","retrogaming","tape-archive","ti994a","vic20","vintage-computers","z1013","z80"],"created_at":"2024-10-02T07:05:00.639Z","updated_at":"2025-04-22T18:20:01.245Z","avatar_url":"https://github.com/stefanschramm.png","language":"TypeScript","funding_links":["https://github.com/stefanschramm/retroload/issues?q=is%3Aissue+is%3Aopen+label%3A%22hardware+donation+request%22"],"categories":[],"sub_categories":[],"readme":"# retroload\n\n[RetroLoad.com](https://retroload.com/) is a web application for converting tape images of historical computers into sound for loading them on real devices using an audio line cable or cassette adapter.\n\nThis repository contains the npm packages\n\n- **retroload**, a command line interface (CLI) for converting tape images to WAVE files or playing them,\n- **retroload-lib**, the fundamental library used by the CLI and RetroLoad.com\n\n**Project state:** A lot is still work in progress. Some of the (more complex) tape archive formats are only partly supported.\n\n## Installation from NPM registry\n\n    sudo npm install -g retroload\n\n## Using retroload CLI\n\nA list of available command line options can be shown using `retroload --help`.\n\n[MACHINES.md](./MACHINES.md) contains some instructions on how to load tapes on different devices.\n\n### Creating WAVE files\n\nConvert an MSX tape archive into an audio file named example.wav:\n\n    retroload retroload-lib/examples/formats/msx_cas_binary/rl.cas -o example.wav\n\nretroload will try to automatically determine the input format by its content and file extension. For formats that are not automatically detected, the `--format` option needs to be specified.\n\n### Playing tape archives directly\n\nWhen the `-o` option is omitted, retroload automatically tries to play the generated audio data.\n\n## Example collection\n\n[./retroload-lib/examples/formats](./retroload-lib/examples/formats) contains minimal example tape archives of different formats for different machines. Some of them, listed in [Examples.ts](./retroload-lib/src/Examples.ts), have successfully been loaded to real machines and can be used for testing. If the example files won't load on your machine, it's unlikely that any other tape archive will successfully load using retroload.\n\n### Rebuilding examples\n\nThere is a Dockerfile that prepares an environment in which the examples can be (re)built. The container has to be started with the formats directory as bind mount to /formats.\n\nRebuilding all examples:\n\n    cd retroload-lib/examples\n    docker build -t retroload-examples .\n    docker run -v \"$(pwd)/formats:/formats\" retroload-examples\n\nOr enter the container to build individual examples:\n\n    docker run -itv \"$(pwd)/formats:/formats\" retroload-examples /bin/bash\n    cd /formats/msx_cas_binary\n    make clean\n    make\n    exit\n\nIf you want to build the examples without Docker, you can look up the Dockerfile for the required tools to be installed in your environment (assemblers, tape format converters).\n\n## Installation from Git repository (development environment)\n\nFor development you can build and install retroload directly from the repository using npm link:\n\n    git clone https://github.com/stefanschramm/retroload.git\n    cd retroload\n    npm ci # install dependencies\n    npm run build # calls TypeScript \"compiler\"\n    sudo npm link retroload/ # the \"/\" is important!\n\nLater you can remove the symlinks by\n\n    sudo npm unlink retroload -g\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefanschramm%2Fretroload","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstefanschramm%2Fretroload","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefanschramm%2Fretroload/lists"}