{"id":32415916,"url":"https://github.com/catsdeservepets/spit","last_synced_at":"2026-05-09T02:03:41.720Z","repository":{"id":309149045,"uuid":"1034821352","full_name":"CatsDeservePets/spit","owner":"CatsDeservePets","description":"spit is a tiny TUI tool that lets you flip through images directly in your terminal.","archived":false,"fork":false,"pushed_at":"2025-08-21T17:57:43.000Z","size":45,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-25T08:38:18.349Z","etag":null,"topics":["command-line","command-line-tool","image","picture","terminal","vim"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CatsDeservePets.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-09T03:52:49.000Z","updated_at":"2025-08-21T17:57:46.000Z","dependencies_parsed_at":"2025-08-10T07:13:43.665Z","dependency_job_id":"99da00cc-b53a-4366-96cd-c65260ad5bef","html_url":"https://github.com/CatsDeservePets/spit","commit_stats":null,"previous_names":["catsdeservepets/spit"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CatsDeservePets/spit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CatsDeservePets%2Fspit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CatsDeservePets%2Fspit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CatsDeservePets%2Fspit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CatsDeservePets%2Fspit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CatsDeservePets","download_url":"https://codeload.github.com/CatsDeservePets/spit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CatsDeservePets%2Fspit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280979466,"owners_count":26423964,"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-25T02:00:06.499Z","response_time":81,"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":["command-line","command-line-tool","image","picture","terminal","vim"],"created_at":"2025-10-25T15:44:47.097Z","updated_at":"2026-05-09T02:03:41.709Z","avatar_url":"https://github.com/CatsDeservePets.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# spit - Show Pictures In Terminal\n\n`spit` is a tiny TUI tool that lets you flip through images directly in your terminal.\n \\\n \\\n\u003cimg src=\"https://github.com/user-attachments/assets/cf1e4eeb-912a-451b-b176-0361cf5ae62e\" width=\"50%\" height=\"50%\"/\u003e\n\n## Installation\n\n```shell\ngo install github.com/CatsDeservePets/spit@latest\n```\n\n## Usage\n\n```\nusage: spit [-h] [-V] [-p] [-c FILE] [-n VALUE] [path ...]\n\nspit - Show Pictures In Terminal\n\npositional arguments:\n  path          image files or directories (default: *)\n\noptions:\n  -h, -help     show this help message and exit\n  -V, -version  show program's version number and exit\n  -p            print default configuration and exit\n  -c FILE       use this configuration file (default: $XDG_CONFIG_HOME/spit/spit.conf)\n  -n VALUE      set initial image using 1-based index or filename (default: 1)\n\nnavigation:\n  l, j          move forward\n  h, k          move backward\n  g             go to first image\n  G             go to last image\n  ?             help\n  q             quit\n```\n\n\u003e [!NOTE]\n\u003e Directory paths must end with a path separator (`/` on Unix, `\\` on Windows).\n\u003e For example: `Downloads/` (not `Downloads`).\n\n## Configuration\n\n### Image previews\n\nTo enable previews, configure a `previewer` command. It runs for each image and draws it. It can talk to a terminal image protocol (e.g. [Kitty](https://sw.kovidgoyal.net/kitty/graphics-protocol/), [iTerm](https://iterm2.com/documentation-images.html)) or call a helper tool (e.g. [chafa](https://github.com/hpjansson/chafa/), [viu](https://github.com/atanunq/viu)).\\\nSee the [Config file](#config-file) section for available expansions.\n\nKitty:\n```shell\npreviewer=\"kitten icat --clear --stdin=no --transfer-mode=memory --place=%cx%r@0x0 --scale-up=yes %f\"\n```\nChafa:\n```shell\npreviewer=\"chafa --clear --size=%cx%r --align=mid,mid %f\"\n```\n\nThere is also a `cleaner` command that clears the previously drawn image. Many tools and protocols already offer a flag to clear.\\\nHowever, in some cases it might still be useful to separate clearing and drawing (e.g. performance reasons).\n\nFor tools without a clear option, you can clear the screen manually:\n\n```shell\ncleaner=\"printf \\033[2J\\033[H\"\n```\n\n\u003e [!NOTE]\n\u003e Protocol support varies by terminal. [Yazi's docs](https://github.com/sxyazi/yazi?tab=readme-ov-file#documentation) have a nice list of different terminals and their supported protocols.\\\n\u003e Tools like `chafa` or `viu` can behave differently across terminals. Be prepared to tweak flags and try out different things to make it all work.\\\n\u003e Using a terminal multiplexer like `Tmux` can also cause issues with some tools.\n\n### Config file\n\nBy default, `spit` loads its configuration from:\n\n\t$XDG_CONFIG_HOME/spit/spit.conf\n\nIf `$XDG_CONFIG_HOME` is not set, it falls back to:\n\n\tLinux    ~/.config/spit/spit.conf\n\tmacOS    ~/Library/Application Support/spit/spit.conf\n\tWindows  %AppData%\\spit\\spit.conf\n\nThe `-config` flag takes precedence over all of the above.\n\n### Default configuration\n\n```shell\n# vim:ft=config\n\n# Command used to cleanup the preview.\n# For more details about expansions, see 'previewer'.\ncleaner=\"\"\n\n# Format string for error messages\nerrorfmt=\"\\x1b[7;31;47m\"\n\n# Enable 'spit' on the following image extensions\nextensions=\"bmp,gif,jpg,jpeg,png,tif,tiff,webp\"\n\n# Use human readable sizes\nhumanreadable=false\n\n# Command used to preview images.\n# Following expansions are available:\n# %c terminal columns\n# %r terminal rows\n# %f file name (including path)\npreviewer=\"kitten icat --clear --stdin=no --transfer-mode=memory --place=%cx%r@0x0 --scale-up=yes %f\"\n\n# Set the look of the statusline.\n# Following expansions are available:\n# %f file name\n# %h image height\n# %w image width\n# %i current index\n# %t total amount of images\n# %s image size\n# %= alignment separator\nstatusline=\"%f %= %wx%h  %s  %i/%t\"\n\n# Whether to set the terminal title to the current image\ntitle=false\n\n# Character used for truncating the statusline when it gets too long\ntruncatechar=\"\u003c\"\n\n# Scroll past the last image back to the first one and vice versa\nwrapscroll=true\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatsdeservepets%2Fspit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcatsdeservepets%2Fspit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatsdeservepets%2Fspit/lists"}