numi Documentation

Beautiful calculator app for macOS, Linux & Windows

6,418 stars JavaScript JavaScript 1 file ยท ~1,759 tokens #app#calculator#cli#converter#extensions#javascript#linux#macos
RAW Doc

File: Readme.md

Numi

Numi is a handy calculator app for macOS. It allows you to describe tasks naturally and instantly get an answer. For example, $20 in euro - 5% discount or today + 2 weeks.

Installation

Desktop version for macOS can be downloaded from the app website or from releases page on GitHub.

Terminal version can be installed using provided shell command (same command used to update binary).

text
curl -sSL https://s.numi.app/cli | sh

Alternative way of installing using Homebrew: brew install nikolaeu/numi/numi-cli.

Alfred extension can be downloaded directly, requires terminal version to work.

Usage

Terminal version can be used this way:

numi-cli "20 inches in cm"

Most features of the Numi for macOS are supported in terminal. However, these are the features that have not yet been implemented:

  • Localization support
  • Tokens (sum, prev, avg)
  • Dates
  • Timezone conversion
  • CSS
  • Variables
  • Plugins/extension

File: plugins/CommunityExtensions/BasicCombinatorics/README.md

Basic Combinatorics Extension for Numi :tada

What is this extension for? :mag_right

This extension allows you to easily calculate the nPr and nCr of two numbers, n and r.

Installation :floppy_disk

Simply download the .js file and copy it to your Numi extensions directory (i.e., ~/Library/Application Support/com.dmitrynikolaev.numi/extensions).

How to use it :wrench

To calculate 6 choose 3, for example, you'd write:

  • choose(6;3)

To calculate 6 permute 3, for example, you'd write:

  • permute(6;3)

Example :memo


File: plugins/CommunityExtensions/ChangeMoneyCAD/README.md

Canadian Money Change Extension for Numi :tada:

What is this extension for? :mag_right:

This extension allows you to easily calculate change (in canadian money) using the standard terminology. It can also be used for informative purposes (for example, how many Nickels do you need to reach 10 000$ CAD).

Installation :floppy_disk:

Simply download the .js file to your numi extensions directory.

How to use it :wrench:

As mentioned above simply use the canadian change terminology. This includes:

  • Nickels (0.05$ CAD)
  • Dimes (0.10$ CAD)
  • Quarters (0.25$ CAD)
  • Loonies (1.00$ CAD)
  • Toonies (2.00$ CAD)

The terminology described above can be used with first letter capital or not. Also, plural and singular are recognized.

Example :memo:


File: plugins/CommunityExtensions/clamp/readme.md

Clamp extension for Numi

What is this extension for? :mag_right:

This extension allows you to limit the minimum and the maximum number range.

Installation :floppy_disk:

Simply download the .js file to your numi extensions directory.

How to use it :wrench:

text
clamp(15;3;7) // 7
clamp(1;3;7) // 3
clamp(5;3;7) // 5

File: plugins/CommunityExtensions/DataRates/README.md

Data rates

What is this extension for? :mag_right:

This extension adds support for computer data rates, such as used to describe network traffic.

It supports both SI units (powers of ten) like kilobyte and binary units (powers of two) like kibibyte, as well as bits and bytes.

Installation :floppy_disk:

Simply download the .js file to your Numi extensions directory.

How to use it :wrench:

Combine any two of the following:

Prefix Symbol Notes
SI k, M, G, T power of 1000
Binary ki, Mi, Gi, Ti power of 1024
Unit Symbol Notes
Bytes per second Bps upper case
Bits per second bps upper case

For example, SI prefix k and bytes-per-second unit Bps makes kBps (note the case!).

Example :memo:

text
# What's the fastest my home broadband can download a file?
96 Mbps in MBpsย =ย 12 Megabytes/s

# How long is that going to take?
filesize = 3 TiBย =ย 3 TiB
rate = 2MBpsย =ย 2 Megabytes/s
time = (filesize / (rate in TiBps)) as secondsย =ย 1,649,267.44 s
time in daysย =ย 19 day 2 h 7 min 47 s

File: plugins/CommunityExtensions/EnginePower/README.md

Engine power Extension for Numi

What is this extension for? :mag_right:

This extension allows you to easily transform engine power from kw to hp and vice versa

Installation :floppy_disk:

Simply download the .js file to your numi extensions directory.

How to use it :wrench:

text
10 kw in hp
10 hp in kw

Example :memo:


File: plugins/CommunityExtensions/LogarithmTotalCalculator/README.md

Find loarithm Extension for Numi

What is this extension for? :mag_right:

This extension allows you to easily calculate a logarithm with any base

Installation :floppy_disk:

Simply download the .js file to your numi extensions directory.

How to use it :wrench:

You can get log base 2 like follows:

log 4

Or any base can be specified as first parameter:

log 2;4


File: plugins/CommunityExtensions/MinMax/README.md

MinMax extension for Numi

What is this extension for? :mag_right:

This extension allows you to determine the minimum or the maximum number in a set of numbers.

Installation :floppy_disk:

Simply download the .js file to your numi extensions directory.

How to use it :wrench:

text
nmin(5;3;7) // 3

x = 7
y = 25
nmax(x;y) // 25

File: plugins/CommunityExtensions/NettTotalCalculator/README.md

Find a Nett Total of a Gross Amount (including tax) Extension for Numi

What is this extension for? :mag_right:

This extension allows you to easily calculate a nett figure from a gross amount. For example, if you are doing your accounts and a supplier has sent an invoice with just a gross figure, you can quickly calculate the nett figure for your accounts. I know this is easy to do on a calculator but it's annoying!

Installation :floppy_disk:

Simply download the .js file to your numi extensions directory.

How to use it :wrench:

text
nett(100) // 83.33
nett(50) // 41.67
nett(187.50) // 156.25
nett(12.1;21) // 10

You can set your default VAT amount in the extension file by editing the line:

var vat = values[1]?.double ?? 20

The terminology described above can be used with first letter capital or not.

Example :memo:


File: plugins/CommunityExtensions/PercentChange/README.md

Percent Change Extension for Numi

What is this extension for? :mag_right:

This extension will calculate the percent change between two values, returning the value as a formatted percentage.

Installation :floppy_disk:

Simply download the .js file to your numi extensions directory.

How to use it :wrench:

text
pc(10;7)
pc(150;225)

Example :memo: