# What's new in Soulver 3?

{% hint style="info" %}
For the latest improvements to Soulver 3, please see the [Change log](https://documentation.soulver.app/changelog).
{% endhint %}

### Interface

* Redesigned user interface. Soulver now manages sheets for you in a sidebar.
  * You can still use the classic "Save documents in Finder" workflow if you prefer.
* Select light mode, dark mode or system defaults from the General preferences.
* Redesigned settings
* An app icon by [Matthew Skiles](https://www.matthewskiles.com/)

### Calculator

* Support for calendar calculations, for example:
  * March 12 + 3 weeks 2 days (4 April)
  * Days between April 3 and June 12 (70 days)
  * August 14 + 3 workdays (August 19)
  * today + 3 weeks
* Support for time calculations, for example:
  * 3:30pm + 2 hours 15 minutes (5:45 pm)
  * 01:02:03 + 01:09:54 (02:11:57)
  * now + 3 hours 25 minutes
* Time zone conversions, for example:
  * Time in New York
  * Time difference between Chicago and Paris
  * 3:30am Moscow to Japan
  * 2am PST to GMT
  * You can use countries as well as common city names (in cases where a country spans multiple timezones, the timezone of the capital city will be used)
* Proportion/'rule of three' functions, for example:
  * 10 is to 20 as 50 is to what (100)
  * 15 is to 30 as what is to 80 (40)
* Functions with multiple parameters, for example:
  * midpoint between 5 and 10 (7.5),
  * 'greater/lesser of', 'remainder of'
* Unix time calculations ('new timestamp', 'march 12 3pm as timestamp')
* ISO8601 date formatting
* Financial functions for compound interest, loan repayments, & return on investment
* Better support for working with rates ('30 hours at $30/hour', '$900 at $30/hour')
* More intuitive syntax for some percentage operators ('50 is 25% of what')
* if/then/else statements
* Random number generator:
  * Random number between 1 and 10

### **Organization**

* Create folders for managing sheets.
* Trash for recovering recently deleted files.
* Drag sheets out of the sidebar to export a .slvr file
* Spotlight search integration, within the app and from the system Spotlight
* Sort sheets by date edited, date created or title
* Import Soulver 2 or Soulver 3 files by dropping them on the dock icon.
* Open specific sheets via URLs

### QuickSoulver

* Perform quick calculations from a Spotlight like interface
* Save your calculations to Soulver as a sheet (⌘S)
* Access a "QuickSoulver" from within Soulver, or the menu bar, or global hotkey

### **Totals & Subtotals**

* Designate a line a subtotal, which will add up all lines above it (up to the next subtotal or heading)
* Smarter total will ignore variable declarations & referenced lines automatically

### Variables

* Variables can now include multiple words
* Auto-complete support for variables (hit the escape key)
* Shift-hover over a variable to see its actual value on that line
* Variables can now be redeclared with new values.

### Editing

* Scrubbable numbers (shift hover over a number to show the scrubber)
* Auto-thousands separator insertion (1000 becomes 1,000)
* QuickOperators (1p1 becomes 1 + 1, etc)
* Keystrokes to insert labels & variable declarations
* Touch Bar support with quick access to operators, sheet defined variables, and line references.
* A preferences to start sheets with a heading or a comment
* Use # for headings, rather than @. Multiple #'s are supported.
  * Customize the color of the # part of a heading in the Styling Preferences

### Units & Currencies

* User definable custom units
* More scientific units
* Better answer formatting of time & imperial lengths
* Support for 22 popular cryptocurrencies
* Better handling of unit calculations in many cases than in Soulver 2.
* All real-world currencies now enabled by default (no need to add them manually)
* Customize currency symbols (i.e choose whether ¥ refers to JPY or CNY)

### Lines & References

* Rearrange & delete lines & via the answer column
* Bump lines up/down using keystrokes
* Reference insertion mode (hit ⌘L, then type the number of the line you want to insert a reference to)

### Files & Locales

* Automatically convert documents created in foreign locales into your preferred locale
* Soulver now uses a JSON based file format (.slvr) rather than XML based (.soulver)
  * You can import your old Soulver 2 files into Soulver 3.

### macOS & Third Party Integrations

* Use Soulver from Terminal with the new CLI
* System-wide "Calculate Anywhere" text services
* A Shortcuts action
* Improved VoiceOver support, with the option of reading out a line's answer after editing
* Search your sheets from Spotlight & get a QuickLook Preview. QuickLook is also supported in Finder.
* Touch Bar support with quick access to operators, sheet defined variables, and line references.
* URL schemes for creating sheets, opening sheets, and doing calculations