{"id":23838294,"url":"https://github.com/shred/tzxtools","last_synced_at":"2025-04-05T16:06:42.504Z","repository":{"id":54266844,"uuid":"67359345","full_name":"shred/tzxtools","owner":"shred","description":"Tools for processing TZX files","archived":false,"fork":false,"pushed_at":"2025-03-18T06:29:32.000Z","size":223,"stargazers_count":109,"open_issues_count":0,"forks_count":25,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-03T11:47:24.359Z","etag":null,"topics":["mirrored-from-codeberg","python","tzx-files","zx-spectrum"],"latest_commit_sha":null,"homepage":"https://codeberg.org/shred/tzxtools","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shred.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2016-09-04T17:40:00.000Z","updated_at":"2025-03-25T19:34:20.000Z","dependencies_parsed_at":"2025-02-25T08:00:47.992Z","dependency_job_id":"ea469d59-8001-4290-b24f-bf548579b76e","html_url":"https://github.com/shred/tzxtools","commit_stats":{"total_commits":87,"total_committers":3,"mean_commits":29.0,"dds":0.02298850574712641,"last_synced_commit":"8ee485e61735fa62572a6248c9119f92cc807892"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shred%2Ftzxtools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shred%2Ftzxtools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shred%2Ftzxtools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shred%2Ftzxtools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shred","download_url":"https://codeload.github.com/shred/tzxtools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247361687,"owners_count":20926643,"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":["mirrored-from-codeberg","python","tzx-files","zx-spectrum"],"created_at":"2025-01-02T16:53:52.188Z","updated_at":"2025-04-05T16:06:42.476Z","avatar_url":"https://github.com/shred.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tzxtools\n\nThis is a collection of command line tools for processing TZX files.\n\nTZX is a common file format for preserving computer tapes of the ZX Spectrum, but also Amstrad CPC, C64 and MSX. `tzxtools` mainly supports ZX Spectrum TZX files, but raw file operations can be applied on any TZX file. It also supports TSX files, which are mainly used for MSX.\n\n## Features\n\n* Convert your old ZX Spectrum tape recordings into TZX files.\n* List, split, merge, and divide the blocks inside TZX files.\n* Play back TZX files and load them into the real hardware.\n* Extract binary content from TZX blocks.\n* Read hex dumps, disassembled Z80 machine code, or ZX Spectrum BASIC code.\n* Convert ZX Spectrum screens to PNG files.\n* Generate TAP files for ZX Spectrum Next and some emulators.\n* Disassembler also supports all undocumented Z80 instructions and Z80N (ZX Spectrum Next) instructions.\n* Also supports TSX Kansas City Standard blocks.\n* All tools can also read TAP files.\n\n## Installation\n\nAll the _tzxtools_ are written in Python 3.\n\n```sh\npip install tzxtools\n```\n\nOn MacOS X, [PortAudio](http://www.portaudio.com/) needs to be installed before:\n\n```sh\nbrew install portaudio\npip3 install tzxtools\n```\n\n## Tools\n\n* `tzxcat` - Extracts data from a TZX file. Optionally disassembles, hex dumps or converts blocks to PNG.\n* `tzxcleanup` - Removes all clutter blocks and leaves a clean TZX file.\n* `tzxcut` - Cuts blocks from a TZX file.\n* `tzxls` - Lists the contents of a TZX file.\n* `tzxmerge` - Concatenates multiple TZX files into one file.\n* `tzxplay` - Plays back a TZX file for loading into a real ZX Spectrum.\n* `tzxsplit` - Splits a TZX file into separate programs.\n* `tzxtap` - Converts a TZX file to TAP file format.\n* `tzxwav` - Converts WAV file ZX Spectrum tape recordings to TZX files.\n\nSee the [documentation](https://shredzone.org/docs/tzxtools/index.html) for how the tools are used.\n\n## File Format References\n\nThe TZX File Format is specified at [World of Spectrum](https://worldofspectrum.net/features/TZXformat.html).\n\nThe TSX \"ID 4B - Kansas City Standard\" block is not a part of the specification. A documentation can be found at the [makeTSX wiki](https://github.com/nataliapc/makeTSX/wiki/Tutorial-How-to-generate-TSX-files#14-the-new-4b-block).\n\nThe TAP File Format is described at [Sinclair Wiki](https://sinclair.wiki.zxnet.co.uk/wiki/TAP_format).\n\n## Contribute\n\n* Fork the [Source code at Codeberg](https://codeberg.org/shred/tzxtools). Feel free to send pull requests.\n* Found a bug? [File a bug report!](https://codeberg.org/shred/tzxtools/issues)\n\n## License\n\n_tzxtools_ is open source software. The source code is distributed under the terms of [GNU General Public License (GPLv3)](https://www.gnu.org/licenses/gpl-3.0.en.html#content).\n\n## Acknowledgements\n\n* I would like to thank all the people who keep the retro computing scene alive.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshred%2Ftzxtools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshred%2Ftzxtools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshred%2Ftzxtools/lists"}