{"id":18535520,"url":"https://github.com/soulverteam/soulver-cli","last_synced_at":"2025-11-01T02:30:30.527Z","repository":{"id":158869076,"uuid":"584311702","full_name":"soulverteam/Soulver-CLI","owner":"soulverteam","description":"A standalone command-line version of Soulver (for macOS)","archived":false,"fork":false,"pushed_at":"2024-08-16T19:32:26.000Z","size":8265,"stargazers_count":27,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-10T21:15:49.952Z","etag":null,"topics":["bc","calculator","soulver","terminal-based"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soulverteam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-02T07:39:44.000Z","updated_at":"2025-02-10T03:48:50.000Z","dependencies_parsed_at":"2024-06-24T13:38:51.358Z","dependency_job_id":"8bb4dcb2-ae99-4d6d-aeb6-e5ef317cd20f","html_url":"https://github.com/soulverteam/Soulver-CLI","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soulverteam%2FSoulver-CLI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soulverteam%2FSoulver-CLI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soulverteam%2FSoulver-CLI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soulverteam%2FSoulver-CLI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soulverteam","download_url":"https://codeload.github.com/soulverteam/Soulver-CLI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239249984,"owners_count":19607354,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bc","calculator","soulver","terminal-based"],"created_at":"2024-11-06T19:24:51.190Z","updated_at":"2025-11-01T02:30:30.465Z","avatar_url":"https://github.com/soulverteam.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Soulver CLI\n\nThis is a free standalone command-line version of [Soulver](https://soulver.app). It's a great alternative to [bc](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) for your terminal.\n\nThis command line tool supports all the same calculation features at the Mac \u0026 iPad versions, including unit conversions, live currency conversions, date \u0026 time math \u0026 all supported natural language functions.\n\nSee Soulver's [documentation](https://documentation.soulver.app) for all supported syntaxes and features.\n\n### System Requirements\n\nRequires macOS 12 or later. \n\nBoth Intel \u0026 Apple Silicon Macs are supported. The tool is notarized and compatible with Gatekeeper.\n\n### Installation\n\nThe easiest way to install the Soulver CLI is with [Homebrew](https://brew.sh):\n\n```\nbrew install soulver-cli\n```\n\nThe Soulver CLI is also available as a downloadable binary from the Github releases page for this repository (or by cloning this repository).\n\nOn first launch the tool will automatically download a ~1MB package file titled `SoulverCore_SoulverCore.bundle` to the same directory from which the tool is run. The bundle must remain in the same directory as the tool.\n\nThe bundle contains json files required to bootstrap the calculation engine and support its various features (unit names, natural function names, city names for timezone conversions, etc). \n### Interactive mode\n\nType `soulver` from Terminal (with no arguments) to open an interactive calculation mode (like bc):\n\n```\n$ soulver\nWelcome to Soulver\n\u003e\u003e\u003e 32% of $340k\n$108800.00\n\u003e\u003e\u003e March 12 + 4 weeks 5 days\n14 April\n\u003e\u003e\u003e 98 USD in JPY\n¥12832\n```\n\nVariable declarations are supported:\n\n```\n\u003e\u003e\u003e bill total = $128.89\n$128.89\n\u003e\u003e\u003e bill total / 5 people\n$25.78\n```\n\n### Direct arguments\n\nYou can launch soulver with a direct argument to be evaluated:\n\n```\n$ soulver 'new timestamp'\n1672646020\n```\n\nOr via a pipe\n```\n$ echo '123 + 456' | soulver\n579\n```\n\nIf you specify a file path as the direct argument each line will be evaluated.\n\n```\n$ soulver myFile.txt\n```\n\n### Live currency rates\n\nAn installation of the [Mac version of Soulver](https://soulver.app) is __not__ required for this command line tool to function, with one exception: this tool does not refresh the latest currency rates on its own.\n\nIf you want the latest currency rates to be accessible to this tool, the Mac version is required to keep currency rates up to date. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoulverteam%2Fsoulver-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoulverteam%2Fsoulver-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoulverteam%2Fsoulver-cli/lists"}