PitchHut logo
A text calculator for natural language expressions with a vim-style interface.
Pitch

Numr is an intuitive text calculator that allows users to perform calculations using natural language expressions. Featuring vim-style editing and a terminal user interface, it offers functionality like variable handling, unit conversions, and live currency exchange rates, making it a versatile tool for calculations on the go.

Description

numr is an innovative text calculator designed for natural language expressions, featuring a user-friendly vim-style Terminal User Interface (TUI). It streamlines complex calculations into simple commands, allowing users to evaluate expressions quickly and intuitively.

Key Features

  • Natural Language Calculations: Effortlessly perform calculations such as 20% of 150, or convert currencies with commands like $100 in euros.
  • Variable Support: Define variables easily, e.g., tax = 15%, and utilize them in expressions like 100 + tax.
  • Unit Conversions: Supports conversions for various units including length, weight, time, temperature, and data sizes.
  • Real-time Currency Conversions: Automatically fetches live exchange rates for multiple currencies including USD, EUR, GBP, JPY, and BTC.
  • Vim-style Editing: Enjoy efficient editing with normal and insert modes, complete with familiar key bindings for seamless navigation.
  • Mouse Support: Scroll through the interface easily using a mouse wheel or trackpad.
  • File Persistence: Saves calculations automatically to a designated config directory, allowing customization of user files.
  • Syntax Highlighting: Clear distinction for numbers, operators, variables, units, and currencies enhances readability.
  • Commenting Support: Include comments with lines starting with # that are ignored in calculations.
  • Toggle Wrap Mode: Easily switch text wrapping with results aligned at the bottom.
  • Automatic Running Total: The footer displays a dynamic sum of all calculations.

Operations & Examples

Supported Operations:

  • Arithmetic: Perform basic operations like addition, subtraction, multiplication, and division.
    10 + 20           → 30
    100 - 25          → 75
    6 * 7             → 42
    100 / 4           → 25
    
  • Percentage Calculations: Handle percentage operations seamlessly.
    20% of 150        → 30
    100 + 15%         → 115
    
  • Functions: Use built-in functions for summation, averages, and other calculations.
    sum(10, 20, 30)   → 60
    avg(10, 20, 30)   → 20
    

Supported Units

The calculator supports numerous units across categories such as:

  • Length: km, m, cm, mm, miles, feet, inches
  • Weight: kg, g, mg, lbs, oz
  • Time: months, weeks, days, hours, minutes, seconds
  • Temperature: Celsius, Fahrenheit
  • Data Sizes: TB, GB, MB, KB
  • Currencies: USD, EUR, GBP, JPY, RUB, ILS, BTC

This project combines functionality and an intuitive interface, making calculations faster and easier than conventional methods.
For more details or to get started, explore the repository on GitHub.

0 comments

No comments yet.

Sign in to be the first to comment.