# What's new in Soulver 3? {% hint style="info" %} For the latest improvements to Soulver 3, please see the [Change log](/changelog.md). {% 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 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://documentation.soulver.app/whats-new.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.