/gat

🐱 cat alternative written in Go.

Primary LanguageGoMIT LicenseMIT

cat alternative written in Go.

GitHub release (latest by date) GitHub all releases GitHub Workflow Status Maintainability Go Report Card LICENSE

Contents

Installation

Homebrew

$ brew install gat

Homebrew Tap

$ brew install koki-develop/tap/gat

go install

$ go install github.com/koki-develop/gat@latest

Releases

Download the binary from the releases page.

Usage

$ gat --help
cat alternative written in Go.

Usage:
  gat [file]... [flags]

Flags:
  -b, --force-binary      force binary output
  -c, --force-color       force colored output
  -f, --format string     output format (default "terminal256")
  -h, --help              help for gat
  -l, --lang string       language for syntax highlighting
      --list-formats      print a list of supported output formats
      --list-langs        print a list of supported languages for syntax highlighting
      --list-themes       print a list of supported themes with preview
      --no-resize         do not resize images
  -p, --pretty            whether to format a content pretty
  -M, --render-markdown   render markdown
  -t, --theme string      highlight theme (default "monokai")
  -v, --version           version for gat

-l, --lang

Explicitly set the language for syntax highlighting.
See languages.md for valid languages.

-f, --format

Set the output format ( default: terminal256 ).
Alternatively, it can be set using the GAT_FORMAT environment variable. See formats.md for valid formats.

-t, --theme

Set the highlight theme ( default: monokai ).
Alternatively, it can be set using the GAT_THEME environment variable. See themes.md for valid themes.

-p, --pretty

Format a content pretty.
For unsupported languages, this flag is ignored.

-M, --render-markdown

Render markdown documents.

-c, --force-color

gat disables colored output when piped to another program.
Settings the --force-color forces colored output to be enabled.
This is useful, for example, when used in combination with the less -R command.

It is also useful to declare the following function to allow gat to be used with a pager.

function gess() {
  gat --force-color "$@" | less -R
}

Print Image

If your terminal supports Sixel, you can print images.

Supported image formats include:

  • JPEG
  • PNG
  • GIF (animation not supported)

☕ Buy me a coffee

If you like this project, please consider buying me a coffee.

Buy Me A Coffee

LICENSE

MIT