unit-convert
v1.0.0Comprehensive unit converter for length, weight, temperature, area, volume, speed, time, and data. Use when: (1) converting between measurement units, (2) calculating unit equivalencies, (3) working with different measurement systems, or (4) any unit conversion needs. Supports metric, imperial, and...
Installation
Unit Converter
Convert between different measurement units. Supports length, weight, temperature, area, volume, speed, time, and data units.
When to Use
- Convert between metric and imperial units
- Calculate unit equivalencies
- Work with different measurement systems
- Convert digital storage sizes
Quick Start
Basic Conversions
python3 scripts/unit-convert.py 100 cm m
# Output: 100 cm = 1 m
python3 scripts/unit-convert.py 10 kg lb
# Output: 10 kg = 22.05 lb
python3 scripts/unit-convert.py 25 C F
# Output: 25 C = 77 F
List Units
python3 scripts/unit-convert.py list length
# Shows all length units
Show Categories
python3 scripts/unit-convert.py categories
Commands
<value> <from_unit> <to_unit>
Convert between units.
Examples:
# Length
python3 scripts/unit-convert.py 100 cm m
python3 scripts/unit-convert.py 5 ft cm
python3 scripts/unit-convert.py 1 mi km
# Weight
python3 scripts/unit-convert.py 10 kg lb
python3 scripts/unit-convert.py 1000 g kg
python3 scripts/unit-convert.py 16 oz lb
# Temperature
python3 scripts/unit-convert.py 25 C F
python3 scripts/unit-convert.py 98.6 F C
python3 scripts/unit-convert.py 300 K C
# Area
python3 scripts/unit-convert.py 100 m2 ft2
python3 scripts/unit-convert.py 1 acre m2
# Volume
python3 scripts/unit-convert.py 1000 ml l
python3 scripts/unit-convert.py 1 gal l
# Speed
python3 scripts/unit-convert.py 100 km/h mph
python3 scripts/unit-convert.py 10 m/s km/h
# Time
python3 scripts/unit-convert.py 3600 s h
python3 scripts/unit-convert.py 7 day h
# Data
python3 scripts/unit-convert.py 1024 B KB
python3 scripts/unit-convert.py 1 GB MB
list <category>
List all units in a category.
Examples:
python3 scripts/unit-convert.py list length
python3 scripts/unit-convert.py list weight
python3 scripts/unit-convert.py list temperature
categories
Show all supported categories.
python3 scripts/unit-convert.py categories
help <category>
Show help for a specific category.
python3 scripts/unit-convert.py help temperature
python3 scripts/unit-convert.py help length
Supported Categories
Length
- Metric: mm, cm, m, km
- Imperial: in, ft, yd, mi, inch, foot, yard, mile
Weight
- Metric: mg, g, kg, t (tonne)
- Imperial: oz, lb, stone, ounce, pound
Temperature
- C - Celsius
- F - Fahrenheit
- K - Kelvin
Area
- Metric: mm², cm², m², km²
- Imperial: in², ft², yd², acre, mi²
Volume
- Metric: ml, l, kl
- Imperial: fl oz, cup, pt, qt, gal
Speed
- Metric: m/s, km/h
- Imperial: ft/s, mph
- Nautical: knot
Time
- Short: ms, s, min
- Long: h, day, week, year
Data
- Binary: B, KB, MB, GB, TB, PB
- (Uses 1024-based conversion)
Unit Aliases
The converter accepts common aliases:
| Standard | Aliases |
|---|---|
| in | inch, inches |
| ft | foot, feet |
| yd | yard, yards |
| mi | mile, miles |
| oz | ounce, ounces |
| lb | pound, pounds |
| pt | pint, pints |
| qt | quart, quarts |
| gal | gallon, gallons |
| ml | milliliter, milliliters |
| l | liter, liters |
| kl | kiloliter, kiloliters |
| h | hour, hours |
| min | minute, minutes |
| s | second, seconds |
| ms | millisecond, milliseconds |
Examples
Everyday Conversions
# Height conversions
python3 scripts/unit-convert.py 180 cm ft
python3 scripts/unit-convert.py 6 ft cm
# Weight conversions
python3 scripts/unit-convert.py 70 kg lb
python3 scripts/unit-convert.py 150 lb kg
# Temperature
python3 scripts/unit-convert.py 32 F C
python3 scripts/unit-convert.py 100 C F
# Area (room size)
python3 scripts/unit-convert.py 100 m2 ft2
python3 scripts/unit-convert.py 1000 ft2 m2
Cooking & Recipes
# Volume conversions
python3 scripts/unit-convert.py 1 cup ml
python3 scripts/unit-convert.py 250 ml cup
python3 scripts/unit-convert.py 1 gal l
# Weight conversions
python3 scripts/unit-convert.py 500 g lb
python3 scripts/unit-convert.py 1 lb g
Travel & Distance
# Distance
python3 scripts/unit-convert.py 100 km mi
python3 scripts/unit-convert.py 50 mi km
# Speed limits
python3 scripts/unit-convert.py 60 mph km/h
python3 scripts/unit-convert.py 100 km/h mph
Digital Storage
# File sizes
python3 scripts/unit-convert.py 1 GB MB
python3 scripts/unit-convert.py 1024 KB MB
python3 scripts/unit-convert.py 1 TB GB
Science & Engineering
# Precise measurements
python3 scripts/unit-convert.py 25.4 mm in
python3 scripts/unit-convert.py 1000 mg g
# Time calculations
python3 scripts/unit-convert.py 365 day h
python3 scripts/unit-convert.py 86400 s day
Tips
- Use the
listcommand to see all available units for a category - Temperature units are case-sensitive (C, F, K)
- For compound units like m/s, use the slash notation
- The converter handles both short and long unit names
- Results are formatted for readability
Troubleshooting
"Cannot convert" error:
- Check unit spelling
- Ensure units are from the same category (e.g., don't convert length to weight)
- Use list command to see available units
Unexpected results: - Temperature conversions use standard formulas - Data conversions use 1024-based (binary) units - Double-check unit case sensitivity
Notes
- Temperature conversions use standard formulas
- Data conversions use binary (1024-based) units
- All other conversions use decimal (1000-based) units
- Results are automatically formatted for readability