1 stable release

1.1.0 Oct 25, 2019

#1138 in Command line utilities


330 lines


Number Converter

Tektronix CodeFactor Build Status

A simple base conversion project in Rust.


Clone the repo and run cargo build --release. The executable numconverter will be in the target/release directory. Run from there, or move/symlink to a location in your PATH (~/bin/ for example).

I alias the name to ncon and derivatives, based on what base I'm inputing:

alias ncon="numconverter"
alias bcon="numconverter --from-base 2"
alias ocon="numconverter --from-base 8"
alias hcon="numconverter --from-base 16"


Built using Rust. (Rust installation instructions).

  • Uses the structopt crate to handle command line input.
  • Uses the clipboard crate to handle read and write to clipboard. [For Linux: x11_clipboard & nix crates]


Dependencies for clipboard functionality include:

  • libxcb-shape0-dev
  • libxcb-xfixes0-dev

Install with

sudo apt-get install libxcb-shape0-dev libxcb-xfixes0-dev


Some basic usage examples are provided below:

Show Examples

Basic decimal conversion

$ numconverter 255
Base 02: 1111_1111
Base 08: 377
Base 10: 255
Base 16: FF

Specify binary input

$ numconverter b 1001
Base 02: 1001
Base 08: 11
Base 10: 9
Base 16: 9

Specify hexidecimal input

$ numconverter h ab12
Base 02: 1010_1011_0001_0010
Base 08: 12_5422
Base 10: 4_3794
Base 16: AB12

Specify output base - binary (base 2) to hexidecimal (base 16)

$ numconverter b 1010 16
Base 16: A

Specify output bases (non standard)

$ numconverter 1234567890 3 5 12 22 32
Base 03: 1001_2001_0011_1220_2200
Base 05: 10_0120_2213_3030
Base 12: 2_A555_5016
Base 22: AJC_3E26
Base 32: 14P_C0MI

Enter numconverter --help for available options.

numconverter [base_char] [from_num] [to_base]... [FLAGS]... [OPTIONS]...

    base_char   (b, o, d, h - binary, octal, decimal, hex) Character
                representing the 'from' base.  If both the base_char and
                the -f/--from-base are provided, base_char will be used.
    from_num    The input number to convert.  Default base 10.
    to_base     A list of base 10 numbers to convert from_num to.  Base
                must be between 2 and 32 inclusive.

    -b, --bare              Disable Pretty Print
    -c, --copy              Copy the resulting ouput to clipboard
        --from-clipboard    Get the input number from clipboard
    -h, --help              Prints help information
        --no-sep            Do not pad the output
    -s, --silent            Do not print output, for use with the clipboard on.
    -V, --version           Prints version information
    -v, --verbosity         Verbosity (more v's, more verbose)

    -f, --from-base <from-base>      Base of the input number [default: 10]
    -p, --pad <pad>                  Pad the output with leading 0s [default: 0]
        --sep-char <sep-char>        Specify spacer char [default: _]
    -l, --sep-length <sep-length>    Put a spacer every N characters [default: 4]


Before submitting a PR, please make sure you have:

  • Run cargo test.
    • This runs all the defined tests. Be sure to add test coverage for your PR when possible! 😁
  • Checked there are no warnings when compiling.
    • cargo clean && cargo build ensures everything is compiled fresh and will give you maximum visibility on warnings.
    • TravisCI will be run with cargo build --features=fail-on-warnings, so give that a check to avoid waiting on the long CI build.
  • Run cargo fmt and commit the result.
    • Some of the results when automatically formatting are not ideal (in my opinion), but a common format is better than inconsistent format (also in my opinion). The default format is a safe decision to be consistent with the rest of the Rust community. If there is a formatting decision you find untenable, open an Issue and start a discussion (please be civil, see the Code of Conduct 😉).


Licensed under either of

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Contributor License Agreement

Contributions to this project must be accompanied by a Contributor License Agreement. You (or your employer) retain the copyright to your contribution; this simply gives us permission to use and redistribute your contributions as part of the project.


Zach Nielsen - @ZNielsen


~65K SLoC