{"id":21783418,"url":"https://github.com/ayecue/gh-image-transformer","last_synced_at":"2025-08-05T16:05:42.528Z","repository":{"id":215017119,"uuid":"737903296","full_name":"ayecue/gh-image-transformer","owner":"ayecue","description":"Transform images to TextMesh Pro Rich-Text tags for Grey Hack","archived":false,"fork":false,"pushed_at":"2024-01-10T23:34:42.000Z","size":4772,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-30T20:06:43.564Z","etag":null,"topics":["greyhack"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/ayecue.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}},"created_at":"2024-01-01T22:53:46.000Z","updated_at":"2025-01-24T05:49:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"b88b89be-26a4-4f5e-8b04-21f3f433eb2d","html_url":"https://github.com/ayecue/gh-image-transformer","commit_stats":null,"previous_names":["ayecue/gh-image-transformer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayecue%2Fgh-image-transformer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayecue%2Fgh-image-transformer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayecue%2Fgh-image-transformer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayecue%2Fgh-image-transformer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ayecue","download_url":"https://codeload.github.com/ayecue/gh-image-transformer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239793105,"owners_count":19697891,"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":["greyhack"],"created_at":"2024-11-27T01:00:55.420Z","updated_at":"2025-08-05T16:05:42.508Z","avatar_url":"https://github.com/ayecue.png","language":"TypeScript","funding_links":[],"categories":["Utils"],"sub_categories":[],"readme":"# gh-image-transformer\n\nThis CLI does not only transform images into TextMesh Pro Rich-Text tags for Grey Hack but also creates animation frames out of GIFs which are usable in Grey Hack.\n\n# Install\n\n```bash\nnpm install -g gh-image-transformer\n```\n\n# Usage\n\n##  Image transformer\n\n```\nUsage: gh-image-transformer [options] \u003cfilepath\u003e [width] [height]\n\nTransform images to TextMesh Rich-Tags output for Grey Hack.\n\nArguments:\n  filepath                                  image to transform\n  width                                     output width of image\n  height                                    output height of image\n\nOptions:\n  -V, --version                             output the version number\n  -o, --output-directory \u003coutputDirectory\u003e  output directory\n  -s, --scale \u003cnumber\u003e                      scale of output\n  -wa, --without-alpha                      ignore alpha channel\n  -h, --help                                display help for command\n```\n\n##  Animation transformer\n\n```\nUsage: gh-animation-transformer [options] \u003cfilepath\u003e [width] [height]\n\nTransform GIFs to TextMesh Rich-Tags output animation frames for Grey Hack.\n\nArguments:\n  filepath                                  image to transform\n  width                                     output width of image\n  height                                    output height of image\n\nOptions:\n  -V, --version                             output the version number\n  -o, --output-directory \u003coutputDirectory\u003e  output directory\n  -s, --scale \u003cnumber\u003e                      scale of output\n  -wa, --without-alpha                      ignore alpha channel\n  -d, --delay \u003cnumber\u003e                      delay between frames\n  -h, --help                                display help for command\n```\n\n# Important info\n\n:warning: **Recently Grey Hack changed to character limit of tags per print line to `2048`. Anything above that causes the image to be displayed incorrectly. So unfortunately for now images have to be very small.**\n\nAssociated changelog for this:\n\u003e \\- Fixed bug that could cause a crash and an unexpected game shutdown when using certain tags in scripting within an infinite loop.\n\nIntroduced via version **v0.9.5683** (public) and **v0.9.5905E** (nightly).\n\n### :sparkles: I've created a BepInEx plugin which circumvents this issue: [Plugin to fix current implementation](https://github.com/ayecue/greyhack-customizable-output)\n\n# How to\n\n## Static Image\n\nStatic images can be simply transformed into TextMesh Pro Rich-Text tags by using:\n```bash\ngh-image-transformer path/to/image.png\n```\n\nOptionally you can also select the width and height. By default, it will resize the image by a width of `16px`. If you want to resize the image by height just place a `-1` at the spot of the `width`.\n\n~~Keep in mind that the images should be kept below 100px since Grey Hack has a limit of `160000` characters for each print line.~~ Please take a look [here](#important-info).\n\nVia the additional options, you can also change the scale of each pixel.\n\n## GIF\n\nGIFs can be transformed into TextMesh Pro Rich-Text tags animation frames by using:\n```bash\ngh-animation-transformer path/to/image.gif\n```\n\nThe options of the animation transformer are the same as the ones from the normal image transformer. There is only one additional option which is about the delay between each frame.\n\n**Note**: It is \u003cu\u003ehighly recommended\u003c/u\u003e to use either [greybel-js](https://github.com/ayecue/greybel-js) or [greybel-vs](https://github.com/ayecue/greybel-vs) to import animations otherwise you end up with a lot of copy paste depending on how many frames the GIF got.\n\nIn case you are using greybel-js you just need to execute `greybel path/to/image.src`. It is recommended to use the `--create-ingame` flag to avoid copy-pasting all the files.\n\nIf you are using greybel-vs you just need to right click on the `image.src` and select `build`. To make it more convenient please make sure to activate the `create-ingame` option.\n\n:warning: \n\n# Example output\n\n![Example output](/assets/example.png?raw=true \"Example image\")\n\n![Example animation output](/assets/animation.gif?raw=true \"Example animation\")","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayecue%2Fgh-image-transformer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fayecue%2Fgh-image-transformer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayecue%2Fgh-image-transformer/lists"}