cnrt

cnrt is a CLI for converting various units including length, light, mass, temperature, time, and volume such as kilometers to miles, pounds to grams, and more. And it's all written in TypeScript! You can find the package on npm.

Installation

npm install -g cnrt # install the package globally (you may need to use sudo)
cnrt 100 -f km -t mi # test the installation

Usage

Please note that the units are case-sensitive (mg ≠ Mg)

| Command | Description | |--------------------|------------------------------| | Arguments: | | | value | value to convert | | Options: | | | -v, --version | output the current version | | -f, --from <from>| from unit | | -t, --to <to> | to unit | | -l, --list | list all available units | | -h, --help | display help for command |

general usage: cnrt [value] [options]

Examples

# convert 1 meter to feet
cnrt 1 -t ft # meter is the default unit for length, so no need to specify -f
# convert 50 Fahrenheit to Celsius
cnrt 50 -f F
# convert 30 pounds to grams
cnrt 30 -f lb -t g

Aliases are supported for most units (e.g. m/meter and ft/foot)

List of available units

cnrt -l

Length (in increasing size order)

lp, am, fm, xu, pm, A, a0, nm, µm, thou, mm, cm, in, dm, l., ft, yd, m, fathom, rod, dam, ch, hm, furlong, km, mi, NM, league, myriameter, Mm, R⊕, ld, ls, LD, Gm, lh, lim, AU, Tm, Pm, ly, pc, Em, Zm, Ym, Hubble length

Light

lm, HK, cp, cd

Mass (in increasing size order)

eV, qg, rg, yg, Da, zg, ag, fg, pg, ng, μg, planck mass, mg, cg, dg, ct, g, dag, ounce, troy ounce, hg, pound, kg, sl, short ton, Mg, long ton, Gg, Tg, Pg, Eg, Zg, Yg, Rg, Qg

Temperature

C, F, K, R, De, N, Re, Ra

Time (in increasing size order)

planck, qs, rs, ys, jiffy, zs, as, fs, S, ps, ns, shake, µs, ms, cs, ds, s, das, min, milliday, moment, hs, centiday, ks, h, deciday, d, wk, decaday, Ms, fortnight, lunar month, mo, quarantine, hectoday, semester, lunar year, common year, tropical year, Gregorian year, y, sidereal year, leap year, olympiad, lustrum, dec, Gs, jubilee, cen, mil, Age, Ts, megaannum, Ps, galactic year, eon, kalpa, Es, Zs, Ys, Rs, Qs

Volume (in increasing size order)

mm3, μL, cm3, mL, cL, cu in, imp fl oz, dL, gi, US dry pt, imp pt, dm3, L, imp qt, US dry qt, board foot, US dry gal, US pk, pk, daL, kenning, US kenning, ft3, US fl oz, US bsh, imp bsh, firkin, kilderkin, hL, US bbl, US beer bbl, US dry bbl, imp bbl, bbl, US pt, yd3, US qt, m3, kL, MTON, US gal, imp gal, dam3, ML, acre ft, hm3, GL, km3, mi3

The units listed above may not be 100% accurate. For the most accurate list, please refer to the source data in src/data or use the cnrt -l command.

Local Development

gh repo clone TetieWasTaken/cnrt # using GitHub CLI
git clone https://github.com/TetieWasTaken/cnrt.git # using git
cd cnrt
npm install
npm run build
node ./dist/index.js

Legal & Disclaimer

This software is provided as is and is not responsible for any damages or losses caused by the software. I do not claim ownership of any of the units listed in the software nor can I guarantee the accuracy of the conversions. The creation and structure of the data was aided by online tools and AI. If you find any errors or issues with the software and data, please create an issue on the GitHub repository.