{"id":16958479,"url":"https://github.com/dohliam/console-image-browser","last_synced_at":"2025-04-14T09:20:29.163Z","repository":{"id":88991861,"uuid":"200762599","full_name":"dohliam/console-image-browser","owner":"dohliam","description":"Console Image Browser (cib) - An interactive wrapper for viewing images in the terminal","archived":false,"fork":false,"pushed_at":"2019-08-06T16:17:51.000Z","size":4,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-27T22:42:39.871Z","etag":null,"topics":["ascii-graphics","terminal-graphics"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","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/dohliam.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":"2019-08-06T02:35:20.000Z","updated_at":"2024-05-04T01:29:51.000Z","dependencies_parsed_at":"2023-06-13T11:15:36.499Z","dependency_job_id":null,"html_url":"https://github.com/dohliam/console-image-browser","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dohliam%2Fconsole-image-browser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dohliam%2Fconsole-image-browser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dohliam%2Fconsole-image-browser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dohliam%2Fconsole-image-browser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dohliam","download_url":"https://codeload.github.com/dohliam/console-image-browser/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248852186,"owners_count":21171843,"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-graphics","terminal-graphics"],"created_at":"2024-10-13T22:42:42.013Z","updated_at":"2025-04-14T09:20:29.158Z","avatar_url":"https://github.com/dohliam.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Console Image Browser (cib) - An interactive wrapper for viewing images in the terminal\n\nConsole Image Browser is a small script wrapper around the [Terminal Image Viewer](https://github.com/stefanhaustein/TerminalImageViewer) and [catimg](https://github.com/posva/catimg/) utilities that lets you quickly view and browse through images on the command-line.\n\n![cib](https://user-images.githubusercontent.com/9295750/62556313-72297400-b829-11e9-8339-4b934dac4a10.gif)\n\n## Requirements\n\n* image_size gem for printing image dimensions\n  * install with: `gem install image_size`\n* Terminal Image Viewer\n  * available from: https://github.com/stefanhaustein/TerminalImageViewer\n  * make sure that the command `tiv` is in your path\n* catimg\n  * available directly from most package managers or [compile from source](https://github.com/posva/catimg/)\n\n## Supported formats\n\n* JPG, PNG, TIF, BMP: via Terminal Image Viewer\n* GIF: via catimg\n\nNote: Terminal Image Viewer is also nominally capable of handling (non-animated) GIFs, but in practice the conversion tends to lock up the terminal, so the much faster catimg is used instead. However, due to the nature of animated GIFs, it is only possible to view them by specifying a single filename directly, as they cannot be included in the regular browsing interface.\n\n## Installation\n\nMake sure you have installed Terminal Image Viewer (and imgcat if you would like to view animated GIFs) and the other requirements. Download or clone the repository. Open the project directory in a terminal and type\n\n    ./cib.rb\n\nConsole Image Browser can be run from its own folder without any special installation (see [invocation](#invocation) section below for details, or if desired it can also be added to your path by copying `cib.rb` to the relevant directory.\n\n## Usage\n\nTo run Console Image Browser in any directory, just type:\n\n    /path/to/cib\n\nThis will start the program and begin browsing all images in the folder (if any). _Note: The following examples will assume that you are entering commands from within the project directory._\n\nThe directory to browse can also be specified as an argument:\n\n    ./cib.rb ~/Pictures\n\nA single image can be viewed directly by specifying an image file instead of a directory:\n\n    ./cib.rb ~/image.jpg\n\nAnimated GIF files can be viewed in the terminal by specifying them directly in the same way as above:\n\n    ./cib.rb ~/image.gif\n\nOnce you have opened a directory of images to browse, navigation is controlled using a series of hotkeys, which are outlined in the [section below](#usage).\n\n### Navigation\n\nThe following keys can be used to browse and view information about the images within the program:\n\n* `n` or `right` or `down` or `PgDn`: Next image\n* `p` or `left` or `up` or `PgUp`: Previous image\n* `home`: First image\n* `end`: Last image\n* `b`: Browse all images in list / folder\n* `1`-`0`: Quick access to the first 10 images in the folder or list (note that 0 represents the 10th image)\n* `i`: Display some brief information about the image (namely, the filename, size, and dimensions)\n\n## To do\n\nPossible additional features for future development:\n\n* Display online images given an image URL\n* Browse all images on a page given a website URL\n* Support for additional image formats\n* Open image in default image viewer\n* Show EXIF metadata\n\nPRs, suggestions, and other contributions are welcome!\n\n## Credits\n\nThis script relies heavily on [Terminal Image Viewer](https://github.com/stefanhaustein/TerminalImageViewer) by Stefan Haustein and [catimg](https://github.com/posva/catimg/) by Eduardo San Martin Morote.\n\nExample images in demo are by [Luc Viatour](https://commons.wikimedia.org/wiki/User:Lviatour) from Wikimedia Commons.\n\n## License\n\nMIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdohliam%2Fconsole-image-browser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdohliam%2Fconsole-image-browser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdohliam%2Fconsole-image-browser/lists"}