Like cat but for pictures.

Display images in the terminal without relying on special protocols or custom fonts. Works on any terminal where true color is supported (most of them).

Go

go install github.com/scottmckendry/pat@latest

Windows

winget install scottmckendry.pat

Nix

Add to your flake inputs:

{
  inputs.pat.url = "github:scottmckendry/pat";
}

Then you can use it in your configuration:

{
  inputs,
  pkgs,
  ...
}:

{
  # Install as a system package
  environment.systemPackages = [
    inputs.pat.packages.${pkgs.system}.default
  ];

  # OR with home-manager
  home.packages = [
    inputs.pat.packages.${pkgs.system}.default
  ];
}

Pat accepts a single argument, the path to the image you want to display. For example:

pat image.jpg

This can be substituted with a URL:

pat https://example.com/image.jpg

For more options, run pat --help.

Contributions of all kinds are welcome! If you encounter a bug, have a question, or have an idea for a new feature, please open an issue. If you want to implement something new or fix an issue, please open a pull request.