{"id":19694845,"url":"https://github.com/kpouer/image2text","last_synced_at":"2026-02-27T05:35:35.237Z","repository":{"id":190993743,"uuid":"672596485","full_name":"kpouer/image2text","owner":"kpouer","description":null,"archived":false,"fork":false,"pushed_at":"2024-07-24T18:38:53.000Z","size":2600,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-02T09:02:51.273Z","etag":null,"topics":["ascii-art","cli","image","image-processing","rust","rust-lang"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/kpouer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2023-07-30T16:10:01.000Z","updated_at":"2024-07-24T18:38:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"3aa84b76-3af2-4e15-b2bb-b9955f9afaf7","html_url":"https://github.com/kpouer/image2text","commit_stats":null,"previous_names":["kpouer/image2text"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/kpouer/image2text","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpouer%2Fimage2text","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpouer%2Fimage2text/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpouer%2Fimage2text/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpouer%2Fimage2text/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kpouer","download_url":"https://codeload.github.com/kpouer/image2text/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpouer%2Fimage2text/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29885894,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-26T23:51:21.483Z","status":"online","status_checked_at":"2026-02-27T02:00:06.759Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ascii-art","cli","image","image-processing","rust","rust-lang"],"created_at":"2024-11-11T19:24:48.644Z","updated_at":"2026-02-27T05:35:35.221Z","avatar_url":"https://github.com/kpouer.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# image2text\n\nAn image converter that will convert an image to an ascii images.\nIt can work in black \u0026 white or color.\n\n## Usage\n\n```\nUsage: image2text [OPTIONS] [FILE]\nconvert an image to ascii art\n\n  -f,  --file \u003cfile\u003e              the image filename you want to conver\n  -h,  --height \u003cheight\u003e          the height of the output ascii art\n  -w,  --width \u003cwidth\u003e            the width of the output ascii art\n  -c,  --color \u003ccolormode\u003e        the color mode of the output ascii art (bw, ansi or truecolor)\n  -i,  --inverted                 Invert the pixels\n  -p,  --pixel \u003cpixel\u003e            the pixel mode of the output ascii art (ascii, ascii2 or unicode)\n  -cp, --custom-pixel \u003cpixel\u003e     the custom pixel of the output ascii art\n  -cr, --char-size-ratio \u003cratio\u003e  the char size ratio of the output ascii art\n```\n### height \u0026 width\n\nYou can specify the height and/or width of the output ascii art.\nIf you don't specify them, the program will use original size of the image \nwith one character per pixel.\nIf you only specify one of them, the program will keep the ratio of the image and use the char size ratio.\n\n### char size ratio\n\nBecause pixels are square, but characters are not, you can choose a ratio between width and height of the characters.\nBy default, the program will use a ratio of 2.05. You can choose another ratio by using the \"-cr\" option.\n\n### color\n\nBy default, the program will use the color mode \"ansi\" with 256 colors.\nIt can also use black \u0026 white mode or even truecolor if your terminal supports 24bits color.\nIt is also possible to choose a background color.\n\n### background color\n\nYou can choose a background color by using the \"-bg\" option.\nThe color codes are ansi color codes. You can find them here: https://en.wikipedia.org/wiki/ANSI_escape_code#Colors\n\n### Inverted\n\nYou can choose to invert the image. In that case the character density will inverted.\n\n## Examples\n\n```bash\nimage2text -f example/simpsons.jpg\n```\n\n![simpsons](example/simpsons_color.png)\n\n```bash\nimage2text -i -c bw -f example/simpsons.jpg\n```\n![simpsons](example/simpsons_bw.png)\n\n```bash\nimage2text -bg 40 -f example/simpsons.jpg\n```\n![simpsons](example/simpsons_color_black_bg.png)\n\n## Licence\n\nThe project is released under MIT licence\n\n## Dependencies\n\nThis project depends on \n- image (https://crates.io/crates/image)\n- rgb2ansi256 (https://crates.io/crates/rgb2ansi256)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkpouer%2Fimage2text","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkpouer%2Fimage2text","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkpouer%2Fimage2text/lists"}