---
name: "rink"
section: "1"
platform: "linux"
package: "rink"
version: "0.9.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/rink"
---

# rink(1)

Unit calculator and dimensional analysis tool

## NAME

rink - Unit calculator and dimensional analysis tool

## SYNPOSIS

```
rink
rink [EXPR]...
rink -f <FILE>
rink (-h | -V | --config-path)
```

## DESCRIPTION

Rink is a unit conversion and calculation tool which can be used for both small and simple arithmetic and more complex dimensionality analysis and other tasks.

## OPTIONS

- **--config-path**

  Prints a path to the config file, then exits.

**--fetch-currency**: Fetches the latest version of the currency data, then exits. Can be used as part of a cron job, possibly together with setting `currency.cache_expiration_enabled` to false.

- **-f**, **--file** \<*file*\>

  Reads expressions from a file, one per line, printing them to stdout and then exitting.

- **-h**, **--help**

  Print help information and then exits.

- **-V**, **--version**

  Prints the current version and then exits.

## EXIT STATUS

Returns 0 unless an error prevented rink from starting up.

## ENVIRONMENT

**NO\_COLORS**

If set to a non-empty string, rink will disable colored text rendering.

## FILES

Rink looks for a configuration file in `$XDG_CONFIG_DIR/rink/config.toml`, see [rink(5)](/rink/5.md).

Rink relies on some data files, which are found using a search path. See [rink-defs(5)](/rink-defs/5.md) and [rink-dates(5)](/rink-dates/5.md).

Downloaded currency data is saved in `$XDG_CACHE_DIR/rink/currency.json`.

## BUGS

 \<https://codeberg.org/tiffany/rink/issues\>

## SEE ALSO

[rink(5)](/rink/5.md), [rink(7)](/rink/7.md), [rink-defs(5)](/rink-defs/5.md), [rink-dates(5)](/rink-dates/5.md)