Skip to content

almonk/ogpk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ogpk (opengraph peek)

ogpk is a simple CLI tool written in Go that fetches OpenGraph data from a given URL. If the optional dependency timg is installed, ogpk can also display the og:image directly in the terminal.

Installation

On macOS:

brew tap almonk/ogpk
brew install ogpk

On linux:

  • Go to the releases page and download the latest release for your platform.
  • Extract the archive and move the executable to a directory in your PATH (e.g. /usr/local/bin)
  • Make the executable executable, e.g.:
chmod +x /usr/local/bin/ogpk

Usage

To fetch OpenGraph data from a website:

ogpk [URL]

For example:

ogpk https://example.com

To display the og:image in the terminal (requires timg):

ogpk [URL] --p

Output data as JSON:

ogpk [URL] --json

Building from source

Clone this repository:

git clone https://github.com/almonk/ogpk.git

Navigate to the cloned directory:

cd ogpk

Build the tool:

go build -o ogpk

This will produce an executable named ogpk in the current directory.

Optional Dependency on timg

ogpk has an optional dependency on timg, a terminal image viewer. If timg is installed and available in the PATH, ogpk can display the og:image directly in the terminal when the --p flag is used.

To install timg, refer to its official documentation.