diff --git a/README.md b/README.md index 9569fb3..4f742c3 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,67 @@ -# ckconv -Commandline unit converter for Bethesda games. +

Bethesda Engine Unit Converter

+
+

GitHub tag (latest by date)  GitHub all releases

+ + + +

This is a commandline utility that converts between common length measurement units & Bethesda's arbitrary Unit

+ +## Features +- Context-Sensitive Notation + - Can be overridden: + - Force standard notation with `--standard` or `--fixed`. + - Force scientific notation with `--scientific` or `--sci`. +- Supports these measurement units: + - Metric + - Includes all metric prefixes from `pico-` to `tera-` + - Imperial + - Includes all Imperial length units listed on [wikipedia](https://en.wikipedia.org/wiki/Imperial_units#Length). + - Gamebryo / CreationKit Units + - Includes all metric prefixes from `pico-` to `tera-` because who doesn't want to use kilounits +- Cross-Platform: + - Windows + - Linux + - macOS + + +If you're new to using CLI programs, see the [beginners guide](https://github.com/radj307/Gamebryo-Engine-Unit-Converter/wiki#detailed-usage-guide-for-less-experienced-terminal-users). + +## Installation + No formal installation is required, simply place the executable somewhere and call it from your preferred shell. + + If you want to be able to use the program no matter your shell's current working directory, you'll need to place the executable in a location found in your `PATH` environment variable. + + The program is small enough to embed within another executable, for an example see [this synthesis patcher](https://github.com/radj307/Metric-Units-Patcher). + +### Adding to your PATH variable + #### Linux + Place the executable in `/usr/local/bin` to add to your path, or add `export PATH='$PATH;'` to the end of `~/.bashrc` + + #### Windows + [See Here](https://stackoverflow.com/a/9546345/8705305) + + #### macOS + I genuinely have no idea as I have never owned or used a mac, but I assume it's similar to Linux. + +## Usage + Use `ckconv -h` or `ckconv --help` to see a usage guide, and documentation on all of the available options. + + Use `ckconv --units` to see a list of all recognized units. + When specifying units, you can use the values in the `Symbol` or `Name` columns. + + ### Examples + Simple conversions, and pipe operators: + ![](https://i.imgur.com/eoeCV8t.png) + ![](https://i.imgur.com/djxJO0t.png) + ![](https://i.imgur.com/AH01PU6.png) + ![](https://i.imgur.com/djxJO0t.png) + ![](https://i.imgur.com/02IlBID.png) + + Multiple conversions at once: + ![](https://i.imgur.com/TPmpR1W.png) + ![](https://i.imgur.com/djxJO0t.png) + ![](https://i.imgur.com/WvhAz51.png) + + Converting 5 picometers to units in standard notation, and response-only mode: + ![](https://i.imgur.com/HoykBM7.png) + ![](https://i.imgur.com/fLj1yvU.png)