Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

release go-test


binq is a light-weight software installer written in Golang.
It downloads stuff via HTTP and extracts them when they are compressed in forms of zip, tar.gz etc.
This tool mainly focuses on executable programs distributed on the internet; and makes it easier when they are not provided by any package manager.

Typical use case is fetching GitHub release assets.
But binq is not limited to it.


System Requirements

Pre-built binaries are available for Windows, macOS and Linux with x86-64 CPU architecture.

binq is logically supposed to work on any machine for which Go can compile codes.


Choose one of below methods:

  • Homebrew or Linuxbrew (using Tap)
  • Download from GitHub releases
  • go get (go command is required)

Description for each method follows.

Homebrew (Linuxbrew)

brew tap progrhyme/tap
brew install binq

Download from GitHub Releases

Download latest binary from GitHub Releases and put it under one directory in $PATH entries.

The following script detects your OS and downloads the latest binq binary into your current directory:

curl -s "" | bash

go get

Just run this:

go get

Usage at a Glance


binq mdbook
binq jq@1.6 -d /usr/local/bin

These commands will install mdbook or jq binary.
If -d|--dir option is not provided, it will be installed at current directory.

Other ways to install stuff:

binq \
  -d path/to/bin

export BINQ_BIN_DIR=path/to/bin
binq kustomize

Other commands:

binq index         # List Items on Index Server
binq self-upgrade  # Upgrade binq binary itself
binq new           # Create Item Manifest
binq revise        # Add/Edit/Delete a version in Item Manifest
binq verify        # Verify checksum of a version in Item Manifest
binq register      # Register or Update Item Manifest onto Local Index Dataset
binq modify        # Modify Item properties on Local Index Dataset
binq deregister    # Deregister Item from Local Index
binq version       # Show binq version

# Show help
binq [COMMAND] -h|--help

See the documentation for details and more information.


The MIT License.

Copyright (c) 2020 IKEDA Kiyoshi.