Kustom Beginner’s Guide – Part 3 – Functions, Formulas and Kodes

Kustom Beginner’s Guide – Part 3 – Functions, Formulas and Kodes

After giving an overview about KLWP basics and creating a first simple Wall it is time to talk about functions, which we kind of already used to create the clock in the Part 2 Preset ("$df(hh)$"). After going through this guide you should be able to use functions and create own magic formulas or kodes like +Carla Jocobs does.

Basic Functions

For displaying text or information in text form Kustom uses simple functions which can be seen in the formula editor. A text preview is always given and mistakes in basic stuff are flagged.

Frank Monza's own Kustom website gives proper information about all the basic functions. Since he uses multiple pages for all of them I transferred his collection to a single page for easier search.

Kustom Functions

Syntax

As you can see Kustom Functions can have different syntaxes but basics are always the same.

Beneath you see 2 examples of how to use functions inside of functions.

Formulas

Formulas are mostly connected functions like $ai(sunset) - ai(sunrise)$ (Note the $ as the borders of a formula)

You can use all math operators like "+", "/" and so on.

The operators will work differently depending on the way you use them, so, let's give some example:

• $2*(2+3)$ will give 6, this is simple math
• $df(s)*2$ will return the number of seconds in current minute and multiply it per 2
• $"foo" + "bar"$ will merge "foo" string and "bar" string resulting in "foobar" text, this is useful when you want to join text sentences and numbers
• $ai(sunset) - ai(sunrise)$ will subtract 2 dates and return the number of seconds between them, in general a date will be converted in seconds by operators so you can then use it in the formulas 

If you need more advanced functions like "floor", "ceil" and "sqrt" please look into the mu() function. (via kustom.uservoice)

I think the mosted used formulas are if conditions where you can use comparisons like:

• "=" (equals)
• ">" (greater)
• ">=" (greater or equal)
• "<" (less)
• "<=" (less or equal)
• boolean operators "&" (AND) or "|" (OR) and parenthesis

Examples are in the codes part of this guide.

Formulas with the Advanced Editor

Text bits aren't the only place for formulas or functions. As you can see in the screenshots below by selecting the item and pressing on the calculator on the top right you presented with the option to use formulas in multiple places (I won't list every place, because it's pointless. just search around).

Always when you see the calculator icon you are good to go.

Kustom even gives to rules what the formula needs to return.