{"id":15769524,"url":"https://github.com/shahank42/img2ascii","last_synced_at":"2026-05-03T04:33:07.060Z","repository":{"id":82459950,"uuid":"550925484","full_name":"shahank42/img2ascii","owner":"shahank42","description":"An application to render bitmap image files as ASCII characters.","archived":false,"fork":false,"pushed_at":"2022-10-13T15:22:39.000Z","size":3168,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-11T14:16:11.438Z","etag":null,"topics":["ascii-art","ascii-graphics","bitmap-images","cli-app","computer-vision","cpp","pixel","terminal"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shahank42.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":"2022-10-13T14:49:01.000Z","updated_at":"2023-05-03T04:24:09.000Z","dependencies_parsed_at":"2023-06-15T19:15:27.512Z","dependency_job_id":null,"html_url":"https://github.com/shahank42/img2ascii","commit_stats":{"total_commits":4,"total_committers":1,"mean_commits":4.0,"dds":0.0,"last_synced_commit":"86ba3b99e0889768d27e1dad5fba68efbc511169"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/shahank42/img2ascii","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shahank42%2Fimg2ascii","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shahank42%2Fimg2ascii/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shahank42%2Fimg2ascii/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shahank42%2Fimg2ascii/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shahank42","download_url":"https://codeload.github.com/shahank42/img2ascii/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shahank42%2Fimg2ascii/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32558667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T03:21:47.309Z","status":"ssl_error","status_checked_at":"2026-05-03T03:21:43.884Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["ascii-art","ascii-graphics","bitmap-images","cli-app","computer-vision","cpp","pixel","terminal"],"created_at":"2024-10-04T14:03:12.630Z","updated_at":"2026-05-03T04:33:07.033Z","avatar_url":"https://github.com/shahank42.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# img2ascii\nA program to render bitmap image files as ASCII characters.\n\n# Usage\nDownload the latest version from the ![Releases page](https://github.com/shahank42/img2ascii/releases/tag/v0.1).\nSimply drag-and-drop the bitmap image file onto the executable file, and fill in the appropriate parameters.\n\n![Demo](https://github.com/shahank42/img2ascii/blob/main/demos/demo-v0.1.gif?raw=true)\n\n* Image Contrast Factor should be a value between 1 and 255.\n\n# Implementation Details\nThis project was really more of an effort to show that no external libraries should be necessary for image processing; that everything can be achieved through vanilla C++17.\n\nIn hindsight this philosophy was erroneous and it is definitely better to use an existing library such as OpenCV for this purpose, and in general any other computer vision related projects.\n\nSome of the resources and repositories I used are listed under:\n* https://www.scratchapixel.com/lessons/digital-imaging/simple-image-manipulations/reading-writing-images: To get an idea of the general projet structure, and find out the various techniques used in computer vision.\n* https://www.dfstudios.co.uk/articles/programming/image-programming-algorithms/image-processing-algorithms-part-5-contrast-adjustment/: For the contrast adjustment algorithm.\n* https://github.com/kbuffardi/Bitmap: For the code on loading bitmap images. Thanks a bunch!\n* https://bitesofcode.wordpress.com/2017/01/19/converting-images-to-ascii-art-part-1/ and https://bitesofcode.wordpress.com/2017/05/27/converting-images-to-ascii-art-part-2/: Super helpful write-ups that explain the entire workflow of the program in an easy-to-understand fashion.\n\n# Known Issues\n* No user input validation done yet (so it's super easy to break the program).\n* Providing an ASCII Image Width longer than the actual number of horizontal pixels in the image causes a memory leak, and temporary freezing of the OS.\n* Slight perspective issue for vertical images (width \u003c height), still thinking of an algorithm that can adjust ASCII-Image proportions to look natural according to a provided constant factor (squishification factor?).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshahank42%2Fimg2ascii","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshahank42%2Fimg2ascii","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshahank42%2Fimg2ascii/lists"}