America is inching towards the metric system.

Unit Conversion is a temperature and dry volume unit conversion tool and RESTful web app.

Converting units between the following types is supported:

• Temperature:
  • Celsius, Fahrenheit, Kelvin, Rankine
• Volumetric:
  • cubic inches, cubic feet, cups, gallons, liters, tablespoons

Unit Conversion can be run as both a command-line utility and as a web application. A downloadable ZIP package with launch scripts for Linux and Windows is available on this site.

1. Command-line

Running the command-line interface requires a Java7, or later, JVM installed on the host computer. If one is not already installed then a compatible JVM can be downloaded from AdoptOpenJDK free of charge.

• Download the latest Unit Conversion CLI package from the Releases page.
• Unzip the package in your home directory (~) if on Linux or to the root of drive C: if on Windows. Unzipping the archive creates directory/folder UnitConversionCLI with all needed resources to run the utility.
• Open a terminal window (Linux) or command-prompt (Windows) and enter the following for usage information:
  • Linux: sh ~/UnitConversionCLI/convert.sh --help
  • Windows: C:\UnitConversionCLI\convert.bat --help

2. Web

A ready to run Docker image of the web interface is available from Docker Hub repository pendracon/unit-conversion:latest. Information and instructions for installing Docker and using Docker on all supported platforms is available on the Docker website.

• Open a terminal window (Linux) or command-prompt (Windows) and enter the following to download and run the Docker image on your system:

docker pull pendracon/unit-conversion:latest
docker run -d -p 8081:8080 pendracon/unit-conversion:latest

Replace port 8081 in the second line with another port if 8081 is already being used on your system.

• Open your web browser and enter localhost:8081/UnitConversion in the location bar to access the web page.