{"id":21532505,"url":"https://github.com/m-valentino/icat","last_synced_at":"2026-04-09T12:00:50.496Z","repository":{"id":65028738,"uuid":"580625777","full_name":"M-Valentino/ICat","owner":"M-Valentino","description":"Have you ever wanted to know what an image looks like without having to leave the terminal? Well you're in luck! Now you can \"cat\" images with this utility called ICat (short for image cat)!","archived":false,"fork":false,"pushed_at":"2023-03-12T18:34:22.000Z","size":43,"stargazers_count":3,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-16T17:29:34.477Z","etag":null,"topics":["bash","cat","image","images","linux","mac","python","terminal","unix","utility","utils"],"latest_commit_sha":null,"homepage":"https://mark-valentino.vercel.app/project/ICat","language":"Python","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/M-Valentino.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-12-21T02:55:47.000Z","updated_at":"2024-08-07T08:53:28.000Z","dependencies_parsed_at":"2023-02-12T19:16:18.413Z","dependency_job_id":null,"html_url":"https://github.com/M-Valentino/ICat","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/M-Valentino%2FICat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/M-Valentino%2FICat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/M-Valentino%2FICat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/M-Valentino%2FICat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/M-Valentino","download_url":"https://codeload.github.com/M-Valentino/ICat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244096749,"owners_count":20397472,"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":["bash","cat","image","images","linux","mac","python","terminal","unix","utility","utils"],"created_at":"2024-11-24T02:20:23.272Z","updated_at":"2025-12-31T00:17:13.742Z","avatar_url":"https://github.com/M-Valentino.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ICat v1.2.0\nHave you ever wanted to know what an image looks like without having to leave the terminal? Well you're in luck! Now you can \"cat\" images with this utility called ICat (short for image cat)! ICat works by reading images and converting them to ASCII text. Images printed to the terminal are displayed in greyscale with 5 colors.\n\nICat is primarily built with Python.\n### Requirements\nThe following is needed on your Mac or Linux installation in order to run ICat:\n- Python3\n- CairoSVG Python library\n- numPy Python library\n- pathlib Python library\n- Pillow Python library\n\nIcat can automatically install the latest versions of these libraries if you wish.\n### Installation\nClone the git repo anywhere you like and then run **./install.sh**. If you get a `Permission denied` error, run the `chmod` command to change the file's permissions.\nThe directory ICat is installed to is `/usr/local/bin/`. If you delete your local clone of the ICat repo, the installation will not be affected.\n\nWhen installing, you will be prompted to answer if your terminal is light or dark. This is to ensure that images display properly and don't appear inverted. You will also be asked if this character, '▓' appears as a square. This is to ensure that images don't appear stretched. If the character appears as a rectangle, images will be printed in \"half pixels\", and as a result, will have more horizontal detail.\n## Running\nTo use ICat, run **icat 'imageFilename'**. You can add arguments after the file name argument.\n- **-c** applies a contour filter to the image.\n- **-i** inverts the image.\n- **-s** sharpens the image.\n- **x1.5** prints image 1.5x larger than the default size.\n- **x2** prints image 2x larger than the default size.\n- **-settings** Changes the settings of ICat.\n- **-version** Displays the version of ICat installed.\n\n## Example\nicating this image:\n\u003cbr\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/79779618/209410544-2d2c89ff-b77f-4165-a294-ebae8efd4de2.gif\"\u003e\n\u003cbr\u003e\nProduces this result:\n\u003cbr\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/79779618/209453438-04fd71a5-0dce-483a-801c-4bcb9eca351d.png\" width=\"400px\"\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm-valentino%2Ficat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm-valentino%2Ficat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm-valentino%2Ficat/lists"}