{"id":20815889,"url":"https://github.com/aurbano/asciimg","last_synced_at":"2026-02-18T12:31:15.207Z","repository":{"id":150149366,"uuid":"42559601","full_name":"aurbano/asciimg","owner":"aurbano","description":":computer: Images on your terminal - Command line tool written in Perl","archived":false,"fork":false,"pushed_at":"2015-09-22T13:22:13.000Z","size":551,"stargazers_count":5,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-09T21:45:33.021Z","etag":null,"topics":["cli","perl","photo","terminal"],"latest_commit_sha":null,"homepage":"https://aurbano.github.io/asciimg","language":"Perl","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/aurbano.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}},"created_at":"2015-09-16T02:28:05.000Z","updated_at":"2023-01-05T19:27:46.000Z","dependencies_parsed_at":"2023-04-08T04:42:50.859Z","dependency_job_id":null,"html_url":"https://github.com/aurbano/asciimg","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/aurbano/asciimg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aurbano%2Fasciimg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aurbano%2Fasciimg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aurbano%2Fasciimg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aurbano%2Fasciimg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aurbano","download_url":"https://codeload.github.com/aurbano/asciimg/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aurbano%2Fasciimg/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29578940,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T08:38:15.585Z","status":"ssl_error","status_checked_at":"2026-02-18T08:38:14.917Z","response_time":162,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cli","perl","photo","terminal"],"created_at":"2024-11-17T21:26:50.582Z","updated_at":"2026-02-18T12:31:15.187Z","avatar_url":"https://github.com/aurbano.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n                 _ _                 \n                (_|_)                \n   __ _ ___  ___ _ _ _ __ ___   __ _ \n  / _` / __|/ __| | | '_ ` _ \\ / _` |\n | (_| \\__ \\ (__| | | | | | | | (_| |\n  \\__,_|___/\\___|_|_|_| |_| |_|\\__, |\n                                __/ |\n                               |___/ \n```\n\u003e /as-keem-ɪdʒ/ or \"askimage\"\n\u003e\n\u003e Command line tool to display images as ascii art on the terminal\n\n![Example](https://raw.githubusercontent.com/aurbano/ascii-tty/master/demos/demo.gif)\n\n## Usage\n```bash\n$ ./asciimg [-c] [-i] [-a] [-s] [-r resolution] [-t threshold] [-s vertical stretching] [image]...\n```\nTested in:\n* Mac OSX\n* Red Hat/Fedora/CentOS\n* Debian Wheezy (ARM)\n\n### Examples\n\n```bash\n$ asciimg -c image.png # print image.png in color\n$ asciimg -c *.png # print all png files in color\n$ echo demos/* | asciimg # print all files in the demos folder in black and white\n```\n\n### Options\n\n```\n$ asciimg -h\nUsage:\n    asciimg [-c] [-i] [-a] [-s] [-r resolution] [-t threshold] [-v vertical stretching] [image]...\n\nOptions:\n    -s      Use only spaces when rendering. Depending on whether you have\n            setup -c and -i this will have different possible outputs, it is\n            probably worth testing.\n\n    -i      Set the color in the background instead of the foreground, good\n            for images that have a white background or bright colors.\n\n    -c      Enable colored output.\n\n    -a      Enable averaging for the image sampling algorithm. Averaging\n            should produce closer representations of the input image, but\n            will slow down the process.\n\n    -t      Color sampling threshold, a higher threshold will generate less\n            transitions between colors in the images, good for images with\n            gradients.\n\n    -r      The resolution is the number of columns used when printing the\n            image. It will default to the current size of the terminal.\n\n    -v      Vertical stretching factor for the image, or aspect ratio. It\n            defaults to 0.5, numbers over 0.5 will stretch the image\n            vertically, under 0.5 they will compress it.\n\n    -m      Display the man page.\n```\n\n\n## Installation\n1. [Download](https://github.com/aurbano/asciimg/archive/master.zip)/Clone repository\n2. `asciimg` is built with Perl at the moment, so you'll need to [install it](http://learn.perl.org/installing/) if your OS doesn't have it already.\n3. Dependencies:\n\nGD Library\n```bash\n# Mac OSX\n$ brew install gd\n# Linux (Ubuntu and similar)\n$ sudo apt-get install libgd-gd2-perl\n# Linux (Fedora, Red Hat...)\n$ sudo yum -y install perl-GD\n```\nWindows: http://gnuwin32.sourceforge.net/packages/gd.htm\n\nConfigure cpan if necessary:\n```bash\n$ sudo perl -MCPAN -e shell\n```\nPerl modules:\n\n#### Mac OSX\nPatch GD from here: http://wangqinhu.com/install-gd-on-mavericks/ *(this fixed all GD issues for me)*\n\nThen install the other dependencies the same way as Linux.\n\n#### Linux\n```bash\n$ sudo cpan\ncpan\u003e install GD::Image\ncpan\u003e install Term::ANSIColor\ncpan\u003e install Term::ReadKey\ncpan\u003e install Pod::Usage\ncpan\u003e install Getopt::Long\n```\n\n## Roadmap\n* \u003cdel\u003eAdd an option to get colored output\u003c/del\u003e\n* Add option to use full square characters/custom characters\n* Package for distribution (working on it)\n\n## Meta\nDeveloped by [Alejandro U. Alvarez](http://urbanoalvarez.es) - \u0026copy; 2015 - Licensed under the MIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faurbano%2Fasciimg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faurbano%2Fasciimg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faurbano%2Fasciimg/lists"}