{"id":21321802,"url":"https://github.com/terrylindev/image-to-ASCII","last_synced_at":"2025-07-12T05:30:29.988Z","repository":{"id":234370298,"uuid":"788751032","full_name":"terrylindev/image-to-ASCII","owner":"terrylindev","description":"🖼️ A command-line tool for converting images to ASCII art","archived":false,"fork":false,"pushed_at":"2024-08-29T05:58:39.000Z","size":10576,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T19:42:27.445Z","etag":null,"topics":["ascii","ascii-art","cli","command-line","cpp","cuda","docker","image-processing","image-to-ascii","mpi","opencv","terminal"],"latest_commit_sha":null,"homepage":"","language":"C++","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/terrylindev.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-04-19T02:28:28.000Z","updated_at":"2024-08-29T05:58:42.000Z","dependencies_parsed_at":"2024-04-21T08:47:47.834Z","dependency_job_id":"ac7b052c-a1cf-4737-b419-24a4765bae45","html_url":"https://github.com/terrylindev/image-to-ASCII","commit_stats":null,"previous_names":["liny18/images-to-ascii","liny18/image-to-ascii","terrylindev/image-to-ascii"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/terrylindev/image-to-ASCII","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terrylindev%2Fimage-to-ASCII","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terrylindev%2Fimage-to-ASCII/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terrylindev%2Fimage-to-ASCII/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terrylindev%2Fimage-to-ASCII/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/terrylindev","download_url":"https://codeload.github.com/terrylindev/image-to-ASCII/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terrylindev%2Fimage-to-ASCII/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264941502,"owners_count":23686498,"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":["ascii","ascii-art","cli","command-line","cpp","cuda","docker","image-processing","image-to-ascii","mpi","opencv","terminal"],"created_at":"2024-11-21T20:10:13.791Z","updated_at":"2025-07-12T05:30:29.556Z","avatar_url":"https://github.com/terrylindev.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Image to ASCII Converter\nTransform your images into ASCII art. Leveraging MPI and optional CUDA support, this application executes parallel processing to ensure both speed and efficiency in image conversion.\n\n## Examples :eyes:\n\n|                     Input                     |                                 Output                                 |\n|-----------------------------------------------|------------------------------------------------------------------------|\n| \u003cimg src=\"images/cpp.png\" width=\"300\"\u003e        | \u003cimg src=\"outputs/cpp_color.png\" width=\"300\"\u003e                          |\n| command:                                      | `mpirun -np 4 ./out -i images/cpp.png -c -w 150`            |\n| \u003cimg src=\"images/hwoarang.png\" width=\"300\"\u003e   | \u003cimg src=\"outputs/hwoarang_color.png\" width=\"300\"\u003e                     |\n| command:                                      | `mpirun -np 4 ./out -i images/hwoarang.png -c -w 150`       |\n| \u003cimg src=\"images/pikachu.png\" width=\"300\"\u003e    | \u003cimg src=\"outputs/pikachu_color.png\" width=\"300\"\u003e                      |\n| command:                                      | `mpirun -np 4 ./out -i images/pikachu.png -c -w 150`        |\n| \u003cimg src=\"images/miffy.png\" width=\"300\"\u003e      | \u003cimg src=\"outputs/miffy_color.png\" width=\"300\"\u003e                        |\n| command:                                      | `mpirun -np 4 ./out -i images/miffy.png -c -w 150`          |\n\n\n## Installation\nIf you do not have Docker installed, install at [Docker🐳](https://docs.docker.com/engine/install/)\n\n## Usage :clipboard:\n### Pull the Docker Image\n- For systems with CUDA support (ensure your environment is CUDA-capable):\n```shell\ndocker pull yuxlin21/image-to-ascii:cuda\n```\n- For systems without CUDA support:\n```shell\ndocker pull yuxlin21/image-to-ascii:latest\n```\n\n### Preparing Your Images\n1. Create an Image Directory:\n   \nCreate a directory on your host machine to store the images you want to convert.\n```shell\nmkdir images\n```\n2. Add Images:\n   \nPlace the images you want to convert into this directory.\n\n### Running The Application\n- Template for running\n```shell\ndocker run -v \"$(pwd)\"/outputs:/app/outputs -v \"$(pwd)\"/images:/app/images -it yuxlin21/image-to-ascii:[latest/cuda] '[COMMAND]'\n```\n- ${PWD} if using PowerShell\n- Choose either latest or cuda depending on your image for [latest/cuda]\n- Replace '[COMMAND]' with these options:\n```\nCommand: 'mpirun -np \u003cINT\u003e (number of processes) ./out [Options]'\nOptions:\n    -h, --help              Display this help message\n    -i, --input  \u003cFILE\u003e     Specify the path of the input image filepath (required)\n    -o, --output \u003cSTRING\u003e   Specify the name of the output file name (e.g. image)\n    -w, --width  \u003cINT\u003e      Set the width of the ASCII output; maintains aspect ratio\n    -s, --chars  \u003cSTRING\u003e   Define the set of characters used in the ASCII output\n    -p, --print             Print the ASCII output to the console\n    -n, --negate            Create a negative ASCII art\n    -f, --factor \u003cFLOAT\u003e    Set the scale factor from 0.1 to 1.0 (default) to resize the image\n    -c, --color             Get ASCII PNGs in colors\n    -t, --threads \u003cINT\u003e     Set the number of threads to use, default is 256  \n```\n- Example\n```shell\ndocker run -v \"$(pwd)\"/outputs:/app/outputs -v \"$(pwd)\"/images:/app/images -it yuxlin21/image-to-ascii:latest 'mpirun -np 1 ./out -i images/hwoarang.png -w 90 -c -p'\n```\n\nNote:\n    When running with CUDA, OpenCV generates many warnings, but they do not affect the usability of the program, safely ignore.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterrylindev%2Fimage-to-ASCII","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fterrylindev%2Fimage-to-ASCII","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterrylindev%2Fimage-to-ASCII/lists"}