This fork contains a fix documented here mattn#21

The PR was made in 2024, and it seems the author is not maintaining the repository anymore.

The screenshot was made using the Foot terminal, but the same behavior occurs in other terminals, such as Windows Terminal.

Code used for the screenshot:

func main() {
  file, _ := os.Open("example.png")
  img, _, _ := image.Decode(file)
  sixel.NewEncoder(os.Stdout).Encode(img)
}

original readme:

go-sixel

DRCS Sixel Encoder/Decoder

Installation

$ go get github.com/mattn/go-sixel

You can install gosr (go sixel renderer), gosd (go sixel decoder) with following installation instruction.

$ go get github.com/mattn/go-sixel/cmd/gosr
$ go get github.com/mattn/go-sixel/cmd/gosd

Command	Description
gosr	Image renderer
gosd	Decoder to png
goscat	Render cats
gosgif	Render animation GIF
gosl	Run SL

Usage

Encode

$ cat foo.png | gosr -

Decode

$ cat foo.drcs | gosd > foo.png

Use as library

img, _, _ := image.Decode(filename)
sixel.NewEncoder(os.Stdout).Encode(img)

License

MIT

Author

Yasuhiro Matsumoto (a.k.a mattn)