{"id":19024205,"url":"https://github.com/sanalzio/pixcii","last_synced_at":"2026-04-29T17:30:16.104Z","repository":{"id":218495792,"uuid":"746542572","full_name":"sanalzio/PixCii","owner":"sanalzio","description":"Free image to ASCII text converter software.","archived":false,"fork":false,"pushed_at":"2024-02-15T06:02:46.000Z","size":50,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-02T01:27:53.668Z","etag":null,"topics":["ascii","ascii-art","cli","command-line","free","free-software","gpl3","gplv3","javascript","jimp","js","node","node-js","nodejs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/sanalzio.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-01-22T08:09:43.000Z","updated_at":"2024-02-05T19:40:05.000Z","dependencies_parsed_at":"2024-02-15T06:46:14.665Z","dependency_job_id":null,"html_url":"https://github.com/sanalzio/PixCii","commit_stats":null,"previous_names":["sanalzio/image2ascii","sanalzio/pixcii"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanalzio%2FPixCii","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanalzio%2FPixCii/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanalzio%2FPixCii/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanalzio%2FPixCii/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sanalzio","download_url":"https://codeload.github.com/sanalzio/PixCii/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240072063,"owners_count":19743527,"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","free","free-software","gpl3","gplv3","javascript","jimp","js","node","node-js","nodejs"],"created_at":"2024-11-08T20:35:33.338Z","updated_at":"2026-04-29T17:30:16.063Z","avatar_url":"https://github.com/sanalzio.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\r\n# PixCii\r\n\r\n![NodeJS](https://img.shields.io/badge/Node.JS-%23378D3B.svg?style=for-the-badge\u0026logo=node.js\u0026logoColor=white) ![Node Version](https://img.shields.io/static/v1?label=Version\u0026message=18.18.0\u0026style=for-the-badge\u0026labelColor=4BAE4F\u0026color=2E7D32\u0026logo=node.js\u0026logoColor=ffffff) ![LICENSE](https://img.shields.io/static/v1?label=LICENSE\u0026message=GPL-V3\u0026style=for-the-badge) [\u003cimg alt=\"downloadbtn\" src=\"https://dabuttonfactory.com/button.png?t=Download\u0026f=Ubuntu-Bold\u0026ts=30\u0026tc=fff\u0026hp=15\u0026vp=15\u0026c=6\u0026bgt=unicolored\u0026bgc=238636\u0026bs=4\u0026bc=37914a\" width=\"77px\"\u003e](https://github.com/sanalzio/PixCii/releases)\r\n\r\n**Free image to ASCII text converter software.**\r\n[What is the free software?](https://en.wikipedia.org/wiki/Free_software)\r\n\r\n```\r\n\r\n\r\n                     PixCii X.X.X\r\n    Simple \"open-source\" image to ASCII text converter.\r\n\r\n    Usage: ./pixcii \u003c*input_file_path\u003e \u003carguments\u003e\r\n    Or you can simply drag and drop the files you want to cut into executable file.\r\n\r\n    Arguments:\r\n\r\n    --help or -h: show undetailed help menu.\r\n\r\n    --deatiledhelp or -dh: show this menu.\r\n\r\n    --out: set output file path.\r\n    Usage: --out \u003coutput_file_path\u003e\r\n\r\n    --size: resize image to specified width and height.\r\n    Usage: --size \u003cwidth (pixels)\u003e \u003cheight (pixels)\u003e\r\n\r\n    -r: reverse the ascii characters.\r\n\r\n    -l: print the ascii text to the console.\r\n\r\n    -i: disable write info to console.\r\n\r\n    -w: removes the whitespaces.\r\n\r\n    -s: disable the resizing performed to maintain the aspect ratio..\r\n\r\n    +\u003cJIMP_Function\u003e: run specified JIMP function before converting to ascii.\r\n    Example: +resize(90,24)\r\n\r\n    --exec: execute the specified javascript code.\r\n    Usage: --exec \"\u003cjavascript code\u003e\"\r\n\r\n    --onconed: execute the specified javascript code on converted.\r\n    Example: --onconed \"\u003cjavascript code\u003e\"\r\n\r\n    --onsvd: execute the specified javascript code on saved.\r\n    Example: --onsvd \"\u003cjavascript code\u003e\"\r\n\r\n    --onst: execute the specified javascript code on start.\r\n    Example: --onst \"\u003cjavascript code\u003e\"\r\n\r\n    --befcon: execute the specified javascript code before converting.\r\n    Example: --befcon \"\u003cjavascript code\u003e\"\r\n\r\n    --execcmd: execute the specified Shell code.\r\n    Usage: --execcmd \"\u003cShell code\u003e\"\r\n\r\n\r\n```\r\n\r\n- [PixCii](#pixcii)\r\n  - [Istallation](#istallation)\r\n  - [Build](#build)\r\n  - [Usage](#usage)\r\n    - [Run like this:](#run-like-this)\r\n    - [Examples](#examples)\r\n  - [Scripting](#scripting)\r\n    - [Using --exec Argument](#using---exec-argument)\r\n    - [Using runCmd Function](#using-runcmd-function)\r\n    - [Using --execcmd Argument](#using---execcmd-argument)\r\n  - [License](#license)\r\n\r\n## Istallation\r\n[\u003cimg alt=\"downloadbtn\" src=\"https://dabuttonfactory.com/button.png?t=Download\u0026f=Ubuntu-Bold\u0026ts=30\u0026tc=fff\u0026hp=15\u0026vp=15\u0026c=6\u0026bgt=unicolored\u0026bgc=238636\u0026bs=4\u0026bc=37914a\" width=\"100px\"\u003e](https://github.com/sanalzio/PixCii/releases)\r\n\r\nDownload PixCii latest relase from [here](https://github.com/sanalzio/PixCii/releases). Or  you can [build](#build) from source. \r\n\r\n## Build\r\n```bash\r\ngit clone https://github.com/sanalzio/PixCii\r\ncd PixCii\r\nnpm install\r\nnode index.js\r\n```\r\n## Usage\r\n\r\n### Run like this:\r\n```bash\r\npixcii \u003cinput_file_path\u003e \u003carguments\u003e\r\n```\r\n\r\n\u003e [!TIP]\r\n\u003e **Or you can simply drag and drop the files you want to cut into executable file**\r\n\r\n### Examples\r\n```bash\r\npixcii image.png\r\npixcii image.png --size 100 50 -r --out output.txt\r\npixcii image.png --size 100 50 -riws\r\npixcii image.png --size 100 50 -rl\r\npixcii image.png --size 100 50 --exec \"console.log(\\\"Done ✔\\\");\"\r\n```\r\n\r\n## Scripting\r\nYou can use scripting to execute JavaScript code or execute Shell code. For better information look Detailed Information.\r\n\r\n### Using --exec Argument\r\n```bash\r\npixcii image.png --exec \"console.log(\\\"Hello World! from --exec arg\\\");\"\r\n```\r\nOutput: Hello World! from --exec arg\r\n### Using runCmd Function\r\n```bash\r\npixcii image.png --exec \"runCmd(\\\"Hello World! from runCmd function\\\");\"\r\n```\r\nOutput: Hello World! from runCmd function\r\n\r\n### Using --execcmd Argument\r\n```bash\r\npixcii image.png --execcmd \"echo Hello World! from --execcmd arg\"\r\n```\r\nOutput:  Hello World! from --execcmd arg\r\n\r\n## License\r\n[GPL-V3](https://www.gnu.org/licenses/gpl-3.0.en.html#license-text)\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanalzio%2Fpixcii","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsanalzio%2Fpixcii","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanalzio%2Fpixcii/lists"}