{"id":24851944,"url":"https://github.com/brhaka/imagetoascii","last_synced_at":"2025-10-10T03:37:06.707Z","repository":{"id":53001112,"uuid":"332439658","full_name":"brhaka/ImageToASCII","owner":"brhaka","description":"Lightweight ImageToASCII converter written in C","archived":false,"fork":false,"pushed_at":"2021-04-10T10:16:26.000Z","size":4909,"stargazers_count":13,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-19T14:08:20.166Z","etag":null,"topics":["ascii","ascii-arts","c","command-line","conversion","converter","fun","image","lightweight"],"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/brhaka.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":"2021-01-24T12:07:40.000Z","updated_at":"2023-09-05T23:26:26.000Z","dependencies_parsed_at":"2022-09-07T22:52:27.186Z","dependency_job_id":null,"html_url":"https://github.com/brhaka/ImageToASCII","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/brhaka/ImageToASCII","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brhaka%2FImageToASCII","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brhaka%2FImageToASCII/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brhaka%2FImageToASCII/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brhaka%2FImageToASCII/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brhaka","download_url":"https://codeload.github.com/brhaka/ImageToASCII/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brhaka%2FImageToASCII/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002620,"owners_count":26083425,"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","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"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","ascii-arts","c","command-line","conversion","converter","fun","image","lightweight"],"created_at":"2025-01-31T14:38:19.318Z","updated_at":"2025-10-10T03:37:06.693Z","avatar_url":"https://github.com/brhaka.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ImageToASCII\n\n[![License](https://img.shields.io/github/license/brhaka/ImageToASCII?style=for-the-badge)](https://github.com/brhaka/ImageToASCII/blob/master/LICENSE)\n[![Release](https://img.shields.io/github/v/release/brhaka/ImageToASCII?color=%234DC820\u0026style=for-the-badge)](https://github.com/brhaka/ImageToASCII)\n[![Size](https://img.shields.io/github/languages/code-size/brhaka/ImageToASCII?style=for-the-badge)](https://github.com/brhaka/ImageToASCII)\n\n[![GitHub stars](https://img.shields.io/github/stars/brhaka/ImageToASCII.svg?style=social\u0026label=Star)](https://github.com/brhaka/ImageToASCII)\n\n## Usage\n\n`ImageToASCII` runs on the Command-Line.\nYou must provide a path to the image you want to convert. You can do this by passing it as a Command-Line argument (`./ImageToASCII \"./image.png\"`). In the case where no argument is passed, ImageToASCII will prompt you to write the image path on the command-line.\n\nAnother input that `ImageToASCII` requires is the `Image Resize Factor`. You can enter a value between `1` and `50`. The image will be resized according to the entered value. E.g.: With a resize factor of 10, a 3840x2160 (pixels) image becomes a 384x216 (characters) ASCII art.\n\nThere are also other inputs ImageToASCII will ask you, such as wether you want to store the path to the image for later use and also wether you want to use the stored path (if previously stored).\n\nThe ASCII art is saved to a file named `ascii.brk`. The extension is symbolic, but since NotePad has a limit of 1024 characters per line, to avoid confusion, it is not saved as a `.txt` file. You can open the `.brk` file with any text editor. Personally, I use [NotePad++](https://github.com/notepad-plus-plus/notepad-plus-plus).\n\nSince the program has no control over which font the ASCII art is being visualized, a whitespace is inserted after each character. E.g.: '@' becomes '@ '\n\n\u003csub\u003e*Please have in mind that the larger your ASCII art is, the more detailed it can be. It will be also heavier. E.g.: 1 character = 1 byte, so a 384x216 ASCII art weights 82.944 bytes PLUS whitespaces between columns. Total of 165.888 bytes.*\u003c/sup\u003e\n\n## Installation\n\nImageToASCII is compiled to a single file, for easier use. There is a specific file for each OS version. If you wish to use ImageToASCII on **Linux**, download the `ImageToASCII-Linux` file. On **MacOS**, download the `ImageToASCII-MacOS` file and on **Windows**, download the `ImageToASCII-Windows_x86_x64.exe` file. You can start your download at the [Releases](https://github.com/brhaka/ImageToASCII/releases) section. It's also possible to [compile the source code](https://github.com/brhaka/ImageToASCII#compiling).\n\nTo start the program, all you need to do is execute it via command-line. E.g: `./ImageToASCII-Linux \"./image.png\"`\n\n### Branches\n\nThe **[master](https://github.com/brhaka/ImageToASCII/tree/master)** branch contains the most recent stable release source code. The **[development](https://github.com/brhaka/ImageToASCII/tree/development)** branch contains the current development source code. It may be unstable.\n\n### Compiling\n\nIt's also possible to download the source code and compile it yourself. First, you must clone or fork this repository into an empty directory. Then, via command-line, you can run the following commands:\n\n`make LINUX` and `make MACOS` will compile the **Linux** and **MacOS** versions of the program. The output files are named `ImageToASCII-Linux` and `ImageToASCII-MacOS`, respectively. This command uses `gcc`. In order to execute it on Linux, it must be compiled on **Linux** and the same rule is applied to **MacOS**.\n\n`make WIN` will compile the **Windows** (x86 and x64) version of the program. The output file is named `ImageToASCII-Windows_x86_x64.exe`. This command uses **mingw**.\n\nThe `make`, `make all`, `make re` and `make ImageToASCII` commands will compile the **Linux**, **MacOS** and **Windows** versions of the program.\n\nTo compile a version that won't use ANSI colors on the output, add `USE_COLORS=0` to your `make *` command. E.g: `make WIN USE_COLORS=0`\n\n## Features\n\n* Supports JPG, JPEG, PNG, TGA, BMP, PSD, HDR, PIC\n* Works with **any** image resolution\n* Clean and detailed ASCII arts\n* **Linux**, **MacOS** and **Windows** versions\n* Lightweight\n* Open Source\n\n## Showcase\n\n### High character count\n\n![Beliaikin](https://user-images.githubusercontent.com/32342284/114232473-d7752700-9973-11eb-9889-dc30f1bb69d8.jpg)\n![Antelope Close-Up](https://user-images.githubusercontent.com/32342284/114233077-b2cd7f00-9974-11eb-932e-b95f23102268.jpg)\n![Leitisvatn](https://user-images.githubusercontent.com/32342284/114232421-c5938400-9973-11eb-8f8b-ac16a543ade0.jpg)\n![Girl Holding Leaf](https://user-images.githubusercontent.com/32342284/114232397-b90f2b80-9973-11eb-9958-1dd4f8296875.jpg)\n\n### Low character count\n\n![Pear Low](https://user-images.githubusercontent.com/32342284/114232801-5d916d80-9974-11eb-88f5-a94218a8a622.jpg)\n![Antelope Close-Up Low](https://user-images.githubusercontent.com/32342284/114232569-f673b900-9973-11eb-874c-675369ebe6ea.jpg)\n\n*Images by [pexels.com](https://www.pexels.com/collections/imagetoascii-vk9vgay/) and [Eirik Sørstrømmen](https://500px.com/photo/122484453/the-cliffs-of-leitisvatn-by-eirik-sorstrommen)*\n\n## Contributing\n**Like what you see?** Please, feel free to fork this repository, and make any change you like. If you\nwant to propose a nice feature, please create a separate branch on your fork,\nnamed after the feature you want to implement, then make a pull request from that\nbranch. Thank you!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrhaka%2Fimagetoascii","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrhaka%2Fimagetoascii","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrhaka%2Fimagetoascii/lists"}