RINK(5)

💖 RINK(5) — the rink manual, config edition 💖

okay bestie, so this is RINK(5) from the Rink Manual — it's the page that explains Rink's config file, and honestly? it ate. let's get into it 🫶

---

✨ NAME ✨

rink — the TOML configuration file format. that's it, that's the vibe. 💅

---

🌸 DESCRIPTION 🌸

Rink's configuration file uses the TOML format. no cap, that's the whole format reveal.

Duration types accept common suffixes like ms, s, h, d, y. Size types accept suffixes like MB. so you can be all "hours" and "megabytes" about it, iconic.

Color strings are a set of keywords separated by spaces. The following keywords are understood:

• black, red, green, yellow, blue, purple, cyan, white, dark_gray, light_red, light_green, light_yellow, light_blue, light_purple, magenta, light_magenta, light_cyan, light_gray — sets the color to that ANSI color. the classics, the main characters 👑
• dim / dimmed — uses a dimmed variant of the color instead of the bright variant.
• bold, italic, underline / under, strikethrough — formatting. yes, you can be dramatic in a terminal.
• hidden / none — makes the text invisible. spooky. it's giving ghost text 👻
• on — the color keyword after this will apply to the background instead of the foreground. Example: black on red.
• default / plain — results in unstyled text. the "no thoughts, head empty" option.
• integers 0 to 255 — extended terminal color palette codes.
• # <6 hex letters> — hex codes can be used to specify truecolor. Example: #000000
• rgb( <red> , <green> , <blue> ) — RGB values can be used to specify truecolor. No spaces are allowed. Example: rgb(10,10,10)

---

💅 Rink

The [rink] section. yes it's named after itself, main character energy.

• prompt = <string> — the text that will be displayed before the cursor, to hint interactivity. Should include the space character. Default: "> "
• long_output = <bool> — breaks lists, such as search results, over multiple lines. Requires a Unicode-capable terminal. Default: false
• show_interpretation = <bool> — shows the input query reformatted based on how Rink interpreted it. Supports syntax highlighting. Default: true

---

💰 Currency

The [currency] section.

• enabled = <bool> — currency support can be disabled entirely. When set to false, the currency.json will not be loaded, and trying to use currency units will give a "not found" error. Default: true
• behavior = <"prompt" | "always"> — Default: "prompt". When attempting to use a currency unit, Rink will ask if you'd like to download the currency data. Setting it to "always" will download immediately when a currency unit is used.
• cache_expiration_enabled = <bool> — Default: true. Setting this to false causes rink to behave as if cache_duration was infinite. If the currency file doesn't exist, it will fetch it, otherwise it will use it indefinitely. Rink can be invoked with --fetch-currency to download the latest version. This setting might be useful for intermittent internet access — you can setup a cron job to fetch the currency data while the network is up, making it available later when using rink offline. lowkey genius for offline girlies 🧚
• endpoint = <url> — allows pointing to alternate Rink-Web instances, or to any other API that offers a compatible format. Default: "https://rinkcalc.app/data/currency.json"
• timeout = <duration> — how long to wait for currency fetching before giving up. Default: "15s"
• cache_duration = <duration> — how long to wait before considering the cached currency data stale. Default: "1h"

---

🌈 Colors

The [colors] section.

• enabled = <bool> — set to true to turn on colored output. Default: true, or false if the NO_COLOR environment variable is set. (yes, env var said "not today" and wins, periodt)
• theme = <string> — sets the active theme. See the THEMES section. Default: "default"

---

🎨 Themes

The [themes] section. This section is a dictionary, each theme should be created as [themes.my_theme]. These options are specific to each.

• plain = <color> — generic text. This will be used often. Default: "default"
• error = <color> — error messages. Default: "red"
• unit = <color> — the names of units, like kilogram. Default: "cyan"
• quantity = <color> — the names of physical quantities, like length and time. These are shown in parentheses on every query. Default: "dimmed cyan"
• number = <color> — numbers that appear in outputs. Default: "default"
• user_input = <color> — used when rink is quoting user input back, such as in unit not found errors. Default: "bold"
• doc_string = <color> — used when rink is showing informational text that's part of the definition of a unit, like meter. Default: "italic"
• pow = <color> — the ^2 in m/s^2. Default: "default"
• prop_name = <color> — names of properties in substances, like the speed in speed of light. Default: "cyan"
• date_time = <color> — date time objects, that can be obtained with the hash notation or now. Default: "default"
• link = <color> — a hyperlink, typically found inside of doc strings. Default: "cyan"
• keyword = <color> — special words in Rink's query language, like of, digits, etc. Default: "yellow"
• timezone = <color> — timezones, like [US/Pacific]. Default: "cyan" 🦋

---

🍓 FILES 🍓

where the config lives, depending on your OS bestie:

• Linux — __$XDG_CONFIG_DIR__/rink/config.toml
• Windows — __{FOLDERID_RoamingAppData}__\rink\config.toml
• macOS — __$HOME__/Library/Application Support/rink/config.toml

---

🦋 SEE ALSO 🦋

rink(1), rink(7), rink-defs(5), rink-dates(5) — go read the whole set, iykyk 💜

---

that's the whole page, bestie — no notes. this was the Rink Manual, version dated 2026-08-30, filed under RINK(5). love u, go configure something iconic 💅✨