https://github.com/danielgatis/imgcat

Display images and gifs in your terminal.

https://github.com/danielgatis/imgcat

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.8%) to scientific vocabulary

Keywords

cli command-line display go golang image image-display image-preview preview terminal terminal-emulator tui

Keywords from Contributors

projection archival distributed observability traces interactive profiles generic sequences genomics
Last synced: 5 months ago · JSON representation

Repository

Display images and gifs in your terminal.

Basic Info
  • Host: GitHub
  • Owner: danielgatis
  • License: mit
  • Language: Go
  • Default Branch: master
  • Homepage:
  • Size: 8.87 MB
Statistics
  • Stars: 266
  • Watchers: 3
  • Forks: 16
  • Open Issues: 3
  • Releases: 21
Topics
cli command-line display go golang image image-display image-preview preview terminal terminal-emulator tui
Created over 5 years ago · Last pushed 8 months ago
Metadata Files
Readme License

README.md

Imgcat

Go Report Card License MIT Go Doc Release

Display images and gifs in your terminal emulator.

Features

  • Animated GIF support
  • Accept media through stdin
  • Transparency

Installation

MacOS

brew install danielgatis/imgcat/imgcat

Linux

First, install snapcraft.

sudo snap install imgcat

Windows

First, install scoop.

scoop bucket add scoop-imgcat https://github.com/danielgatis/scoop-imgcat.git scoop install scoop-imgcat/imgcat

Download binaries

Alternatively, you can download a pre-built binary here.

Build from source

First, install Go.

Next, fetch and build the binary.

bash go install github.com/danielgatis/imgcat@latest

or, if you use pre-1.17 Go version, use the go get command:

bash go get -u github.com/danielgatis/imgcat

Usage

Display a remote image

curl -s http://input.png | imgcat

Display a local image

imgcat path/to/image.png

Options

  • -h, -help: Show help message
  • -interpolation: Set interpolation method (default: lanczos)
    • nearest: Fastest resampling filter, no antialiasing.
    • lanczos: A high-quality resampling filter for photographic images yielding sharp results.
  • -silent: Hide Exit message (default: false).
  • -top-offset: Offset from the top of the terminal to start rendering the image (default 8)
  • -type: Image resize type. Options: fit, resize (default "fit")

Requirements

Your terminal emulator must be support true color and use a monospaced font that includes the lower half block unicode character (▄ U+2584).

License

Copyright (c) 2020-present Daniel Gatis

Licensed under MIT License

Buy me a coffee

Liked some of my work? Buy me a coffee (or more likely a beer)

Buy Me A Coffee

Owner

  • Name: Daniel Gatis
  • Login: danielgatis
  • Kind: user
  • Location: Recife - PE

GitHub Events

Total
  • Create event: 8
  • Release event: 9
  • Issues event: 3
  • Watch event: 71
  • Delete event: 7
  • Issue comment event: 4
  • Push event: 9
  • Pull request event: 2
  • Fork event: 5
Last Year
  • Create event: 8
  • Release event: 9
  • Issues event: 3
  • Watch event: 71
  • Delete event: 7
  • Issue comment event: 4
  • Push event: 9
  • Pull request event: 2
  • Fork event: 5

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 56
  • Total Committers: 8
  • Avg Commits per committer: 7.0
  • Development Distribution Score (DDS): 0.214
Past Year
  • Commits: 9
  • Committers: 3
  • Avg Commits per committer: 3.0
  • Development Distribution Score (DDS): 0.333
Top Committers
Name Email Commits
Daniel Gatis d****s@g****m 44
dependabot[bot] 4****] 6
harvastum H****m@G****m 1
goreleaserbot g****r@c****m 1
Zhizhen He h****i@g****m 1
Nishith Savla 6****a 1
James Pirruccello j****s@c****m 1
aleksandras a****l@g****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 9 months ago

All Time
  • Total issues: 9
  • Total pull requests: 14
  • Average time to close issues: 6 months
  • Average time to close pull requests: 29 days
  • Total issue authors: 9
  • Total pull request authors: 7
  • Average comments per issue: 3.11
  • Average comments per pull request: 0.21
  • Merged pull requests: 11
  • Bot issues: 0
  • Bot pull requests: 8
Past Year
  • Issues: 2
  • Pull requests: 3
  • Average time to close issues: 22 days
  • Average time to close pull requests: 29 days
  • Issue authors: 2
  • Pull request authors: 2
  • Average comments per issue: 1.5
  • Average comments per pull request: 0.0
  • Merged pull requests: 3
  • Bot issues: 0
  • Bot pull requests: 2
Top Authors
Issue Authors
  • SoloSynth1 (1)
  • avivajpeyi (1)
  • carbocation (1)
  • brian6932 (1)
  • Kreijstal (1)
  • rashil2000 (1)
  • hom (1)
  • jiDOK (1)
  • mistydemeo (1)
Pull Request Authors
  • dependabot[bot] (10)
  • AKrylatych (2)
  • bozkayasalihx (1)
  • hezhizhen (1)
  • harvastum (1)
  • carbocation (1)
  • Nishith-Savla (1)
Top Labels
Issue Labels
Pull Request Labels
dependencies (10) go (2)

Packages

  • Total packages: 1
  • Total downloads: unknown
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 23
proxy.golang.org: github.com/danielgatis/imgcat
  • Versions: 23
  • Dependent Packages: 0
  • Dependent Repositories: 1
Rankings
Stargazers count: 4.6%
Dependent repos count: 4.7%
Average: 6.7%
Forks count: 7.8%
Dependent packages count: 9.6%
Last synced: 6 months ago

Dependencies

go.mod go
  • github.com/creack/pty v1.1.17
  • github.com/disintegration/imaging v1.6.2
  • github.com/gabriel-vasile/mimetype v1.4.0
  • github.com/mat/besticon v3.12.0+incompatible
  • github.com/mattn/go-isatty v0.0.14
  • golang.org/x/image v0.0.0-20191009234506-e7c1f5e7dbb8
  • golang.org/x/net v0.0.0-20210505024714-0287a6fb4125
  • golang.org/x/sys v0.0.0-20220227234510-4e6760a101f9
go.sum go
  • github.com/creack/pty v1.1.17
  • github.com/disintegration/imaging v1.6.2
  • github.com/gabriel-vasile/mimetype v1.4.0
  • github.com/mat/besticon v3.12.0+incompatible
  • github.com/mattn/go-isatty v0.0.14
  • golang.org/x/image v0.0.0-20191009234506-e7c1f5e7dbb8
  • golang.org/x/net v0.0.0-20210505024714-0287a6fb4125
  • golang.org/x/sys v0.0.0-20201119102817-f84b799fce68
  • golang.org/x/sys v0.0.0-20210423082822-04245dca01da
  • golang.org/x/sys v0.0.0-20210630005230-0f9fa26af87c
  • golang.org/x/sys v0.0.0-20220227234510-4e6760a101f9
  • golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1
  • golang.org/x/text v0.3.0
  • golang.org/x/text v0.3.6
  • golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e
.github/workflows/goreleaser.yml actions
  • actions/checkout v2 composite
  • actions/setup-go v2 composite
  • goreleaser/goreleaser-action v2 composite
  • samuelmeuli/action-snapcraft v1 composite