Localization

What this page is

Settings → Localization holds two settings: the language the app speaks, and the base currency money is counted in. As the hint under the currency puts it, "Goals, auction and statistics are counted in it. Donations in other currencies are converted at the exchange rate".

How to set it up

1. Open Settings → Localization. Both settings already have a value before you touch anything: on the very first start the app takes the language from your system and the currency from your system region. It only asks when your system language is none of the ones it ships with — one screen titled "Language · Язык", once.
2. Interface language — pick one of six: English, Русский, Español, Português, Deutsch, Français. Each name is written in its own language, so you can find yours without reading the others. The choice applies the moment you pick it — the language has no save button of its own — and it carries over to the module pages and the Control Panel tiles. Overlays already running in OBS follow it too, with three exceptions: Alerts Widget, Donation Goals and Lists write the language into the link you copy into a browser source, and a source added before the switch keeps the old language. Copy the link again on that widget's own page and paste it into the source in OBS.
3. Base currency — pick one of the fourteen in the list: USD — US dollar, EUR — Euro, GBP — Pound sterling, RUB — Russian ruble, KZT — Kazakhstani tenge, UAH — Ukrainian hryvnia, BYN — Belarusian ruble, PLN — Polish zloty, TRY — Turkish lira, GEL — Georgian lari, AMD — Armenian dram, AZN — Azerbaijani manat, UZS — Uzbek sum, KGS — Kyrgyz som.
4. Press Save Settings beside the currency list. Picking a currency changes nothing on its own — it is stored when you press that button, which goes through "Saving…" to "Saved".
5. If donation records in another currency exist, a confirmation named Convert history opens: "Convert the donation history to {currency} at the current rate? Records in another currency: {count}. Totals for past streams will change — this is a one-time operation, after it the numbers stay fixed again." Convert history agrees, Cancel leaves the history untouched.
6. A record is converted from the sum the platform actually sent, not from the result of an earlier conversion, so changing the currency twice does not pile up rounding. Stream totals and the donor tops are rebuilt from the converted records afterwards.
7. The line under the currency reports where the history stands: "Records in another currency: {count}. Until converted, totals mix currencies." or "The whole donation history is in this currency." While a conversion runs it reads "Converting…".
8. The Convert history button next to that line is shown only while records in another currency remain — that is how you convert later if you pressed Cancel. Once everything is in one currency, the button disappears.
9. The box at the bottom says whether there is anything to convert with. "Rates come from the Currency Rates module. While it is off, donations in other currencies are counted as-is, without conversion." With the module on it reads "The Currency Rates module keeps rates up to date — donations in other currencies are converted automatically." Open rate settings goes to that module, Settings → Currency Rates.

What it cannot do

• Rates are neither shown nor edited here. This page only reports whether the Currency Rates module is on, and links to it.
• A record the app has no rate for is left exactly as it was — converting skips it instead of counting it as zero. So the line can still report records in another currency right after a conversion, and with the Currency Rates module off that is everything not already in the new currency.
• The base currency is one setting for the whole app — there is no separate currency per module, per platform or per goal.
• Nothing outside the fourteen currencies in the list can be chosen.
• Converting is all or nothing: no picking a period or particular records, and the page has no undo — the confirmation calls it a one-time operation.
• The six languages in the list are all there are. The app offers only those whose dictionary came with your copy, and a seventh cannot be added from this page.
• Language and base currency are separate settings. Picking Deutsch does not switch money to euro, and picking EUR does not switch the app to German.