Gnumero Guide

A compact, keyboard-first calculator and developer command palette for GNOME Shell. Results update while you type, stay structured by value type, and can be copied without reaching for the mouse.

Getting Started

Press Super+C to open Gnumero.
Type an expression. The result appears immediately below it.
Press Enter to copy the primary result and close.

Type help and press Enter at any time to open this guide.

Keyboard Controls

Key	Action
`Super+C`	Open or close Gnumero
`Enter`	Copy the primary result and close
`Ctrl+C`	Copy selected input, or copy the result when nothing is selected
`Up / Down`	Navigate up to 100 successful expressions
`Escape`	Close without copying

Arithmetic and Scientific Functions

Gnumero supports parentheses, unary signs, modulo, right-associative powers, constants, angles, nested functions, and exact integer factorials.

Input	Output
`6 * 7`	`42`
`1 / 137`	`0.0072992700729927005`
`(1 + 2) * 3`	`9`
`-2 ^ 2`	`-4`
`10 mod 3`	`1`
`2 ^ 10`	`1024`
`20!`	`2432902008176640000`
`sin(deg(30))`	`0.5`
`sqrt(ln(12) * sin(deg(30)) + 2)`	`1.800681…`
`pi * 2`	`6.283185307179586`

Functions: sqrt, cbrt, abs, ln, log, log2, log10, sin, cos, tan, asin, acos, atan, floor, ceil, round, min, and max. Constants: pi, e, and tau.

Percentages

Input	Output
`10% of 450`	`45`
`450 + 10%`	`495`
`450 - 10%`	`405`
`10% on 450`	`495`
`10% off 450`	`405`
`50 is what % of 200`	`25%`

Programmer Calculator

Integer literals may be decimal, hexadecimal (0x), octal (0o), or binary (0b). Binary output is grouped for readability but copied without spaces.

Input	Primary output
`0xCAFEBABE`	`3405691582`
`0xF0 & 0x3F`	`48`
`0b1010 xor 0b1100`	`6`
`1 << 8`	`256`
`255 as hex`	`0xFF`
`255 as base36`	`73`
`base("FF", 16)`	`255`
`0xFF as int8`	`-1`
`-1 as uint8`	`255`
`rol(0x81, 1, 8)`	`0x3`
`popcount(0xF0)`	`4`
`0x12345678 as le`	`78 56 34 12`
`1.5 as float32hex`	`0x3FC00000`

Additional helpers include bit, setbit, clearbit, togglebit, testbit, clz, ctz, rol, ror, swap16, swap32, swap64, bytes, gcd, lcm, isprime, nextprime, prevprime, comb, and perm.

Text, bytes, Base64, and hashes

Text is encoded as UTF-8. Decoded control characters are escaped on screen but copied as their real values.

Input	Output
`hex("GNOME")`	`47 4E 4F 4D 45`
`str("68 65 79 21 0A")`	`hey!\n`
`base64("gnumero")`	`Z251bWVybw==`
`unbase64("Z251bWVybw==")`	`gnumero`
`len("🌍a")`	`2`
`bytelen("Привет")`	`12`
`"hello" as carray`	`{ 0x68, 0x65, 0x6C, 0x6C, 0x6F }`
`crc32("hello")`	`3610A686`
`md5("password")`	`5f4dcc3b5aa765d61d8327deb882cf99`
`sha256("hello")`	`2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824`

Physical Units

Use in, to, or as for explicit conversions. Without a target, Gnumero suggests one or two useful conversions. SI data units use powers of 1000; IEC units, such as MiB, use powers of 1024.

Input	Output
`10 C`	`50 °F`, then `283.15 K`
`100 C in F`	`212 °F`
`1 mi in km`	`1.609344 km`
`1 km + 500 m`	`1.5 km`
`2 * pi * 6371 km`	`40030.17 km`
`1 kg in lb`	`2.204623 lb`
`88 mph as km/h`	`141.6223 km/h`
`1 GiB in MiB`	`1024 MiB`
`1 kWh in MJ`	`3.6 MJ`
`ohm(5 V, 20 mA)`	`250 ohm`
`parallel(10 kohm, 10 kohm)`	`5 kohm`
`4 GB / 100 Mbps`	`5m 20s`

Supported dimensions include length, mass, temperature, area, volume, speed, time, data size, data rate, pressure, energy, power, voltage, current, resistance, capacitance, and frequency. The symbols Ω, kΩ, and MΩ are accepted as input aliases; output uses ohm, kohm, and Mohm.

Dates and Durations

Input	Output
`today + 45 days`	A date 45 days from today
`tomorrow + 2 months`	Calendar-aware date result
`June 12 2026 + 30 days`	`2026-07-12`
`days between Jun 12 and Jul 15`	`33 days`
`2h 30m + 45m`	`3h 15m`
`93784 seconds in hours`	`26.05111 hours`
`timestamp(now)`	Current Unix timestamp in seconds
`date(1786153900)`	Date and time for that Unix timestamp

Colors

Colors have a structured RGBA value and a preview swatch. Supported inputs include CSS HEX, RGB(A), HSL(A), HSV, and CMYK.

Input	Output
`#eb4034`	`rgba(235, 64, 52, 1)` plus CMYK, HSV, and HSL
`#eb4034 as hsl`	`HSL(4°, 82%, 56%)`
`rgb(255, 0, 0) as hex`	`#FF0000`
`hsl(0, 100%, 50%) as rgb`	`rgb(255, 0, 0)`
`contrast(#000, #fff)`	`21:1`
`mix(#ff0000, #0000ff, 50%)`	A purple ColorValue and swatch

Networking, Coordinates, and Previous Results

Input	Output
`192.168.1.42/24`	Address, network, broadcast, mask, and host count
`255.255.255.0 as cidr`	`/24`
`/24 as mask`	`255.255.255.0`
`192.168.1.42 as int`	`3232235818`
`coord(56.838377, 60.603445) as dms`	`56° 50' 18.1608" N, 60° 36' 12.4044" E`
`ans * 2`	Twice the last explicitly copied result

random(), randint(min, max), and uuid() are available for intentionally non-deterministic values. Everything else works fully offline.