Calcator documentation — syntax, variables, units

Getting Started

Calcator is a calculator notebook that lets you write calculations like notes. Each line can contain an expression, variable definition, or comment.


                salary = 5000

                rent = 1800

                remaining = salary - rent

                # → 3200

Variables

Define variables with name = value and reuse them throughout your notebook.


                price = 100

                quantity = 5

                total = price * quantity

                # → 500

Special variables:

prev - References the result of the previous line

Units & Currency

Work with real-world units and convert between them seamlessly.

Supported Units

Currency

$, €, £, ¥

Weight

kg, g, lb

Distance

km, m, mi

Examples

Unit Conversion


                  12kg in g → 12000g

                  5mi in km → 8.047km

Unit Arithmetic


                  2kg + 500g → 2.5kg

                  $100 + €50 → mixed currency

Percentages

Natural percentage operations that work like you think.

Define Percentages


                  tax = 20%

                  discount = 15%

Add/Subtract


                  100 + 20% → 120

                  100 - 20% → 80

Calculate


                  10% of 500 → 50

                  salary = 5000

                  10% of salary → 500

Compare


                  50 as a % of 100 → 50%

Functions

Built-in mathematical functions and constants.


                sqrt(16) → 4

                abs(-5) → 5

                round(3.7) → 4

                pi * 2 → 6.283...

Available functions: sqrt, abs, round, and more
Constants: pi, e

Block Aggregates

Calculate totals within blocks using sum and average.


                rent = 1800

                food = 400

                transport = 200

                sum → 2400

                

                average → 800

Editor Features

Smart Autocomplete

As you type, Calcator suggests variables, functions, and units. Use ↑/↓ to navigate, Enter or Tab to accept.

Variable Renaming

Right-click a variable to rename it everywhere in your notebook. All references update automatically.

Display Options

Line numbers (toggleable)
Active line highlighting (toggleable)
Inline error underlining (toggleable)
Resizable results panel

Multi-Tab Interface

Work on multiple notebooks at once. Each tab is independent with its own variables and calculations.

Tab Features

Drag and drop to reorder tabs
Tab titles show filename or first variable name
Dirty indicator (*) for unsaved changes
Reopen last 20 closed tabs with ⌘⇧T

Auto-Restore

When you close Calcator, all open tabs are saved. When you reopen, everything is restored exactly as you left it - even unsaved tabs.

Keyboard Shortcuts

File Operations

New Tab	⌘T
Open File	⌘O
Save	⌘S
Save As	⌘⇧S
Close Tab	⌘W
Reopen Closed Tab	⌘⇧T

Editing

Duplicate Line	⌘⇧D
Move Line Up/Down	⌥↑/↓

Settings

Result Display

Choose how the result is displayed (thousands separator, decimal separator, etc.).

Result Precision

Choose between 0-16 decimal places for your results.

Rounding Modes

Half Even (default)
Up
Down
And more...

Editor Preferences

Show/hide line numbers
Enable/disable active line highlighting
Show/hide inline error underlining

All settings are automatically saved and persist between sessions.

Documentation