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
list command 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
1---2name: unit-convert3description: Comprehensive 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 digital units.4---56# Unit Converter78Convert between different measurement units. Supports length, weight, temperature, area, volume, speed, time, and data units.910## When to Use1112- Convert between metric and imperial units13- Calculate unit equivalencies14- Work with different measurement systems15- Convert digital storage sizes1617## Quick Start1819### Basic Conversions20```bash21python3 scripts/unit-convert.py 100 cm m22# Output: 100 cm = 1 m2324python3 scripts/unit-convert.py 10 kg lb25# Output: 10 kg = 22.05 lb2627python3 scripts/unit-convert.py 25 C F28# Output: 25 C = 77 F29```3031### List Units32```bash33python3 scripts/unit-convert.py list length34# Shows all length units35```3637### Show Categories38```bash39python3 scripts/unit-convert.py categories40```4142## Commands4344### `<value> <from_unit> <to_unit>`45Convert between units.4647**Examples:**48```bash49# Length50python3 scripts/unit-convert.py 100 cm m51python3 scripts/unit-convert.py 5 ft cm52python3 scripts/unit-convert.py 1 mi km5354# Weight55python3 scripts/unit-convert.py 10 kg lb56python3 scripts/unit-convert.py 1000 g kg57python3 scripts/unit-convert.py 16 oz lb5859# Temperature60python3 scripts/unit-convert.py 25 C F61python3 scripts/unit-convert.py 98.6 F C62python3 scripts/unit-convert.py 300 K C6364# Area65python3 scripts/unit-convert.py 100 m2 ft266python3 scripts/unit-convert.py 1 acre m26768# Volume69python3 scripts/unit-convert.py 1000 ml l70python3 scripts/unit-convert.py 1 gal l7172# Speed73python3 scripts/unit-convert.py 100 km/h mph74python3 scripts/unit-convert.py 10 m/s km/h7576# Time77python3 scripts/unit-convert.py 3600 s h78python3 scripts/unit-convert.py 7 day h7980# Data81python3 scripts/unit-convert.py 1024 B KB82python3 scripts/unit-convert.py 1 GB MB83```8485### `list <category>`86List all units in a category.8788**Examples:**89```bash90python3 scripts/unit-convert.py list length91python3 scripts/unit-convert.py list weight92python3 scripts/unit-convert.py list temperature93```9495### `categories`96Show all supported categories.9798```bash99python3 scripts/unit-convert.py categories100```101102### `help <category>`103Show help for a specific category.104105```bash106python3 scripts/unit-convert.py help temperature107python3 scripts/unit-convert.py help length108```109110## Supported Categories111112### Length113- **Metric**: mm, cm, m, km114- **Imperial**: in, ft, yd, mi, inch, foot, yard, mile115116### Weight117- **Metric**: mg, g, kg, t (tonne)118- **Imperial**: oz, lb, stone, ounce, pound119120### Temperature121- **C** - Celsius122- **F** - Fahrenheit123- **K** - Kelvin124125### Area126- **Metric**: mm², cm², m², km²127- **Imperial**: in², ft², yd², acre, mi²128129### Volume130- **Metric**: ml, l, kl131- **Imperial**: fl oz, cup, pt, qt, gal132133### Speed134- **Metric**: m/s, km/h135- **Imperial**: ft/s, mph136- **Nautical**: knot137138### Time139- **Short**: ms, s, min140- **Long**: h, day, week, year141142### Data143- **Binary**: B, KB, MB, GB, TB, PB144- (Uses 1024-based conversion)145146## Unit Aliases147148The converter accepts common aliases:149150| Standard | Aliases |151|----------|---------|152| in | inch, inches |153| ft | foot, feet |154| yd | yard, yards |155| mi | mile, miles |156| oz | ounce, ounces |157| lb | pound, pounds |158| pt | pint, pints |159| qt | quart, quarts |160| gal | gallon, gallons |161| ml | milliliter, milliliters |162| l | liter, liters |163| kl | kiloliter, kiloliters |164| h | hour, hours |165| min | minute, minutes |166| s | second, seconds |167| ms | millisecond, milliseconds |168169## Examples170171### Everyday Conversions172```bash173# Height conversions174python3 scripts/unit-convert.py 180 cm ft175python3 scripts/unit-convert.py 6 ft cm176177# Weight conversions178python3 scripts/unit-convert.py 70 kg lb179python3 scripts/unit-convert.py 150 lb kg180181# Temperature182python3 scripts/unit-convert.py 32 F C183python3 scripts/unit-convert.py 100 C F184185# Area (room size)186python3 scripts/unit-convert.py 100 m2 ft2187python3 scripts/unit-convert.py 1000 ft2 m2188```189190### Cooking & Recipes191```bash192# Volume conversions193python3 scripts/unit-convert.py 1 cup ml194python3 scripts/unit-convert.py 250 ml cup195python3 scripts/unit-convert.py 1 gal l196197# Weight conversions198python3 scripts/unit-convert.py 500 g lb199python3 scripts/unit-convert.py 1 lb g200```201202### Travel & Distance203```bash204# Distance205python3 scripts/unit-convert.py 100 km mi206python3 scripts/unit-convert.py 50 mi km207208# Speed limits209python3 scripts/unit-convert.py 60 mph km/h210python3 scripts/unit-convert.py 100 km/h mph211```212213### Digital Storage214```bash215# File sizes216python3 scripts/unit-convert.py 1 GB MB217python3 scripts/unit-convert.py 1024 KB MB218python3 scripts/unit-convert.py 1 TB GB219```220221### Science & Engineering222```bash223# Precise measurements224python3 scripts/unit-convert.py 25.4 mm in225python3 scripts/unit-convert.py 1000 mg g226227# Time calculations228python3 scripts/unit-convert.py 365 day h229python3 scripts/unit-convert.py 86400 s day230```231232## Tips233234- Use the `list` command to see all available units for a category235- Temperature units are case-sensitive (C, F, K)236- For compound units like m/s, use the slash notation237- The converter handles both short and long unit names238- Results are formatted for readability239240## Troubleshooting241242**"Cannot convert" error:**243- Check unit spelling244- Ensure units are from the same category (e.g., don't convert length to weight)245- Use `list` command to see available units246247**Unexpected results:**248- Temperature conversions use standard formulas249- Data conversions use 1024-based (binary) units250- Double-check unit case sensitivity251252## Notes253254- Temperature conversions use standard formulas255- Data conversions use binary (1024-based) units256- All other conversions use decimal (1000-based) units257- Results are automatically formatted for readability