https://github.com/apchavan/go-search-docker-hub-image

Interactive terminal tool to Search Docker Hub Images (written in Go)!
https://github.com/apchavan/go-search-docker-hub-image

docker docker-engine-api docker-hub docker-images docker-search go golang

Last synced: about 1 month ago
JSON representation

Interactive terminal tool to Search Docker Hub Images (written in Go)!

• Host: GitHub
• URL: https://github.com/apchavan/go-search-docker-hub-image
• Owner: apchavan
• License: mit
• Created: 2023-06-09T14:41:04.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2023-07-04T15:16:59.000Z (almost 3 years ago)
• Last Synced: 2025-07-03T17:51:49.042Z (11 months ago)
• Topics: docker, docker-engine-api, docker-hub, docker-images, docker-search, go, golang
• Language: Go
• Homepage:
• Size: 49.8 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

[![GitHub go.mod Go version of a Go module](https://img.shields.io/github/go-mod/go-version/gomods/athens.svg)](https://github.com/gomods/athens) [![GoReportCard](https://goreportcard.com/badge/github.com/apchavan/go-search-docker-hub-image)](https://goreportcard.com/report/github.com/apchavan/go-search-docker-hub-image) ![](https://img.shields.io/badge/OS-Linux-orange) ![](https://img.shields.io/badge/OS-macOS-black) ![](https://img.shields.io/badge/OS-Windows-blue) [![Go Reference](https://pkg.go.dev/badge/github.com/apchavan/go-search-docker-hub-image.svg)](https://pkg.go.dev/github.com/apchavan/go-search-docker-hub-image)

# Search for Docker Hub Images

It's a helper mini-tool that can be used to search images available on [Docker Hub](https://hub.docker.com/) within terminal. It works the same way as [`docker search`](https://docs.docker.com/engine/reference/commandline/search/) command but adds some interactive controls while searching.

**Note**:

- [Docker](https://www.docker.com/) must be installed & running to use this application, because it uses [official Docker Engine's Go SDK](https://docs.docker.com/engine/api/sdk/) to communicate with the Docker Daemon/Engine.

## Main Features

- Interactive terminal UI to search for any Docker Hub images.

- Easily set filters or limits for the search.

- Automatically result sorting based on highest to lowest stars count.

- At present, no credentials/sign-in is required! Just run Docker Daemon/Engine & have internet connection...

- Fully open source under MIT license!

## Working Demo

https://github.com/apchavan/go-search-docker-hub-image/assets/49102443/41d2d881-2c74-418b-924d-4b6df61b72e2

## Dependencies

Currently the project depends on:

1. [docker](https://docs.docker.com/engine/api/sdk/) - Docker provided API for interacting with the Docker daemon (called the Docker Engine API).

2. [tview](https://github.com/rivo/tview) - Terminal UI library with rich, interactive widgets — written in Golang.

3. [go-pretty](https://github.com/jedib0t/go-pretty) - Table-writer and more in golang!

## Build Binary

After installing [Go](https://go.dev), enter below command from project's root,

- On Linux/UNIX,

    `go build -o search_docker_hub_image ./cmd/search_docker_hub_image.go`

- On Windows,

    `go build -o search_docker_hub_image.exe ./cmd/search_docker_hub_image.go`

## Run Directly with Source Code

After installing [Go](https://go.dev), clone/download this project & enter below command from project's root,

`go run ./cmd/search_docker_hub_image.go`