{"id":13789912,"url":"https://github.com/UnsignedArduino/Image-to-MakeCode-Arcade","last_synced_at":"2025-05-12T07:31:14.806Z","repository":{"id":110637925,"uuid":"463277968","full_name":"UnsignedArduino/Image-to-MakeCode-Arcade","owner":"UnsignedArduino","description":"A Python tool to convert an image or GIF file to a MakeCode Arcade image / array!","archived":false,"fork":false,"pushed_at":"2024-11-23T21:53:54.000Z","size":19,"stargazers_count":6,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-24T01:42:12.017Z","etag":null,"topics":["arcade","converter","gif","gifs","image","image-converter","images","makecode","makecode-arcade","python","tool","tools"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UnsignedArduino.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,"zenodo":null}},"created_at":"2022-02-24T19:35:54.000Z","updated_at":"2024-11-23T21:53:57.000Z","dependencies_parsed_at":"2025-04-24T01:32:48.094Z","dependency_job_id":"0b34f6fc-bb5e-483f-a207-0a5360be00bf","html_url":"https://github.com/UnsignedArduino/Image-to-MakeCode-Arcade","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnsignedArduino%2FImage-to-MakeCode-Arcade","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnsignedArduino%2FImage-to-MakeCode-Arcade/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnsignedArduino%2FImage-to-MakeCode-Arcade/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UnsignedArduino%2FImage-to-MakeCode-Arcade/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UnsignedArduino","download_url":"https://codeload.github.com/UnsignedArduino/Image-to-MakeCode-Arcade/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253695083,"owners_count":21948811,"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":["arcade","converter","gif","gifs","image","image-converter","images","makecode","makecode-arcade","python","tool","tools"],"created_at":"2024-08-03T22:00:34.474Z","updated_at":"2025-05-12T07:31:14.792Z","avatar_url":"https://github.com/UnsignedArduino.png","language":"Python","readme":"# Image-to-MakeCode-Arcade\n\nA Python tool to convert a MIDI file to a MakeCode Arcade song!\n\nWeb version will be available soon in a different repo.\n\n## Install\n\n1. Download and install Python.\n2. Clone this repo.\n3. Install all the requirements in [`requirements.txt`](requirements.txt)\n\n\u003e You may need to edit commands listed in this repo to use `py` or `python3`\n\u003e if `python` doesn't work.\n\n\u003e Don't want to/can't install `numpy` or `scipy`? Go to\n\u003e [`scr/converter.py`](src/converter.py) and change the import statements to\n\u003e use Python-only palette processing!\n\u003e (change it to import [`utils.palette`](src/utils/palette.py) instead of\n\u003e [`utils.fast_palette`](src/utils/fast_palette.py)) It will be slower but\n\u003e won't matter unless you are converting huge GIFs\n\n## Usage\n\nRun [`src/main.py`](src/main.py) at the root of the repository in the terminal.\n(It is a CLI app)\n\n### Example commands\n\nTo convert the JPEG file `image.jpg` and print the Arcade image to standard\noutput with the default palette and no resizing.\n\n```commandline\npython src/main.py -i \"image.jpg\"\n```\n\nTo preview the JPEG file at the absolute path\n`E:\\Arcade Image to Image\\testing\\image.jpg` and write the output to\n`image.ts` in the current directory with a width of 160 and a height of 120,\nand with debug messages on.\n\n```commandline\npython src/main.py -i \"E:\\Arcade Image to Image\\testing\\image.jpg\" -o \"image.ts\" --width 160 --height 120 --debug --preview\n```\n\nTo convert the GIF file `image.gif` and write the output to `image.ts` in the\ncurrent directory.\n\n```commandline\npython src/main.py -i \"image.gif\" -o \"image.ts\" --gif\n```\n\n### Help text\n\n```commandline\nusage: main.py [-h] -i PATH [-o PATH] [-p] [--width W] [--height H]\n               [--palette PALETTE] [-g] [--debug]\n\nConvert an image to a MakeCode Arcade image!\n\noptions:\n  -h, --help            show this help message and exit\n  -i PATH, --input PATH\n                        The input image.\n  -o PATH, --output PATH\n                        The output text file which contains a MakeCode Arcade\n                        image.\n  -p, --preview         Whether to preview the outputted image in the default\n                        image viewer instead of writing to a file or standard\n                        output.\n  --width W             The width of the resulting MakeCode Arcade image.If\n                        height is omitted, aspect ratio will be respected.\n  --height H            The height of the resulting MakeCode Arcade image.If\n                        width is omitted, aspect ratio will be respected.\n  --palette PALETTE     The palette to use. Must be a string of comma\n                        separated 6-digit hex codes. For example: \"#000000,#ff\n                        ffff,#ff2121,#ff93c4,#ff8135,#fff609,#249ca3,#78dc52,#\n                        003fad,#87f2ff,#8e2ec4,#a4839f,#5c406c,#e5cdc4,#91463d\n                        ,#000000\" (that is the default palette for this tool\n                        and MakeCode Arcade)\n  -g, --gif             Whether to try to read the image as a GIF. If\n                        specified, the output will be a TypeScript list of\n                        images.\n  --debug               Include debug messages. Defaults to info and greater\n                        severity messages only.\n```\n","funding_links":[],"categories":["Tools"],"sub_categories":["Image-to-MakeCode-Arcade"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUnsignedArduino%2FImage-to-MakeCode-Arcade","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FUnsignedArduino%2FImage-to-MakeCode-Arcade","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUnsignedArduino%2FImage-to-MakeCode-Arcade/lists"}