{"id":13439184,"url":"https://github.com/eddieantonio/imgcat","last_synced_at":"2025-05-16T15:04:34.792Z","repository":{"id":24456245,"uuid":"27859104","full_name":"eddieantonio/imgcat","owner":"eddieantonio","description":"It's like cat, but for images.","archived":false,"fork":false,"pushed_at":"2024-06-28T14:59:13.000Z","size":1500,"stargazers_count":888,"open_issues_count":4,"forks_count":33,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-12-17T21:43:56.459Z","etag":null,"topics":["256-colors","ansi","cli","color","hacktoberfest","image","imgcat","iterm2","terminal"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eddieantonio.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":"2014-12-11T07:21:31.000Z","updated_at":"2024-12-16T07:51:17.000Z","dependencies_parsed_at":"2023-12-18T14:33:53.260Z","dependency_job_id":"45b9c65c-5a7e-4032-8afb-f6694b56b492","html_url":"https://github.com/eddieantonio/imgcat","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eddieantonio%2Fimgcat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eddieantonio%2Fimgcat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eddieantonio%2Fimgcat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eddieantonio%2Fimgcat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eddieantonio","download_url":"https://codeload.github.com/eddieantonio/imgcat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248564774,"owners_count":21125412,"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":["256-colors","ansi","cli","color","hacktoberfest","image","imgcat","iterm2","terminal"],"created_at":"2024-07-31T03:01:11.807Z","updated_at":"2025-04-12T11:49:02.659Z","avatar_url":"https://github.com/eddieantonio.png","language":"C","funding_links":[],"categories":["C","Tools"],"sub_categories":["C"],"readme":"imgcat\n======\n\n[![Build Status](https://github.com/eddieantonio/imgcat/workflows/Build%20and%20test%20imgcat/badge.svg\\?branch\\=master)](https://github.com/eddieantonio/imgcat/actions)\n\nIt's like `cat` but for images.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/eddieantonio/i/raw/master/imgcat.png\" alt=\"running `imgcat cat.jpg`\" width=506 height=620\u003e\n\u003c/p\u003e\n\n\nInstall\n-------\n\nOn macOS:\n\n```sh\nbrew install eddieantonio/eddieantonio/imgcat\n```\n\n**Important**: [See below](#note-on-iterm2s-shell-integration) if\nyou're using iTerm2 3.0 with shell integration installed.\n\nFor other platforms, see [Build](#build).\n\n\nUsage\n-----\n\n```sh\nimgcat some_image.jpg\n```\n\nSee the [manpage](./docs/imgcat.1.md) for more invocations.\n\nNote on iTerm2's shell integration\n----------------------------------\n\nIf you install iTerm2's [shell integration], chances are you also\ninstalled its additional scripts, including one called `imgcat`.\n**iTerm's `imgcat` overrides this program by default**. To see if this\nis happening to you, use `which` to determine where your shell is\nfinding imgcat:\n\n    which imgcat\n\nIf it says `imgcat: aliased to /Users/yourusername/.iterm2/imgcat`, then\nyou must edit your shell startup file and add `unalias imgcat` **after**\nthe line that sources iTerm2's script. For example:\n\n    test -e ${HOME}/.iterm2_shell_integration.zsh \u0026\u0026 source ${HOME}/.iterm2_shell_integration.zsh\n    unalias imgcat\n\n[shell integration]: https://www.iterm2.com/documentation-shell-integration.html\n\nBuild\n-----\n\n### Clone\n\nYou must use `git clone --recurse-submodules` to clone this repository with its dependency, [CImg]:\n\n    git clone --recurse-submodules https://github.com/eddieantonio/imgcat.git\n\n\n### Requirements\n\nTo build from source, you need the following:\n\n - GNU make\n - pkg-config\n - ncurses with header files\n\nOn Debian/Ubuntu/Mint/etc. you can get these packages with this\ncommand:\n\n    sudo apt-get install build-essential pkg-config libncurses5-dev\n\n### Recommended dependencies\n\nThese dependencies are not necessary, but if `pkg-config` manages to\nfind a compatible version on the system, `imgcat` will link to it!\n\n - libpng (any 1.x version supported by [CImg])\n - libjpeg (any version supported by [CImg])\n\nOn Debian/Ubuntu/Mint/etc. you can get these packages with this\ncommand:\n\n    sudo apt-get install libpng-dev libjpeg-dev\n\nThen:\n\n```sh\n./configure\nmake\n```\n\nInstall\n-------\n\nTo install to `/usr/local`:\n\n```sh\nmake install\n```\n\nTo change the default prefix, simply provide `PREFIX=...`\nto `make install`:\n\n```sh\nmake install PREFIX=/opt\n```\n\nAcknowledgements\n----------------\n\n - Uses the [CImg], distributed under the [CeCILL-C] license.\n - 256 Color chart and data from Jason Milkin's [public domain chart][256svg].\n\n[CImg]: https://github.com/dtschump/CImg\n[CeCILL-C]: http://www.cecill.info/licences/Licence_CeCILL-C_V1-en.txt\n[256svg]: https://gist.github.com/jasonm23/2868981\n\nLicense\n-------\n\nCopyright © 2014–2023 Eddie Antonio Santos.\nDistributed under the terms of the [ISC license](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feddieantonio%2Fimgcat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feddieantonio%2Fimgcat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feddieantonio%2Fimgcat/lists"}