Skip to content

Settings

Lanework has two places for settings. The Settings window holds what belongs to you and this Mac. Board Settings holds what belongs to one board. Where the same choice exists in both, the board’s own value wins. For the files behind them, see Configuration.

Choose Lanework ▸ Settings… (⌘,). The window is one scrolling page in three sections, then Colors and Notes.

Every row shows whether you have changed it (Set) or it is still on its default (Default), with a button to put it back. A line under each row says when a change takes effect. Most take effect at once.

SettingWhat it does
HandleWhat @you means on this Mac. It matches mentions of you, fills the @ typeahead, and decides which waiting flags are yours. The default is your Mac user name.

These are defaults for every board that does not set its own. Under each row, the window lists the boards that do override it.

SettingWhat it does
Due soonHow many days ahead a due date counts as due soon and marks the card face. 0 to 365.
Activity logThe level a board’s activity log writes at (Off, Error, Warning, Info or Debug) and how many days of log files to keep. Boards in iCloud Drive never log.
Image sizesThe square sizes the image picker offers when you type ![]( in a card.
Short IDWhether a card’s face shows its short id: Show, Don’t show, or Show while holding ⌥.
SettingWhat it does
Reopen boards at launchReopens the boards that were open when you last quit.
NotificationsA short sound, and a beat on the card’s face, when a waiting flag arrives for you. The flag and its count show either way.
Return posts a commentOn: Return posts the comment you are writing and ⇧Return starts a new line. Off: the other way round. ⌘↩ posts either way.
Templates repositoryThe GitHub repository the New Board gallery reads its templates from, as https://github.com/owner/repo.

Show Palette… opens the Colors window: every colour name a board can use, in two lists, “Foreground — icon tints” and “Background — card and lane fills”. Each row shows its light and dark swatches and a sample, and Copy Name copies the name so you can use it in a file or give it to an agent. Colours marked “Not offered in icon pickers” are for fills only. For how names are used in files, see Shared values.

The Notes section is the free text at the bottom of the settings file. Edit it, then choose Done. Restore Stock Text puts the app’s own text back without touching any setting.

The Settings window’s toolbar has Open Config File, which opens the file the window edits in Lanework’s editor. Hold ⌥ to open it in your default editor instead. Holding ⌥ while you choose Settings… opens the file directly.

Choose Board ▸ Board Settings…. The window is titled with the board’s name and has these sections. Rows that follow your Mac’s value say “From this Mac” until you set the board’s own.

SectionWhat is in it
CardsCard body preview (None, or 2 to 5 lines of a card’s first paragraph on its face), Due soon, Short ID, Move receipts.
WindowShow trash and Show status bar, the same as View ▸ Show Trash and View ▸ Show Status Bar.
ImagesImage sizes, including “Full size only”.
Activity LogLog level and Log retention. Turned off for a board kept in iCloud Drive.
Label KindsThe board’s label kinds. See below.
DescriptionThe board’s description text. Edit, then Done. Open in Editor opens it in Lanework’s editor.
The Board Settings window for Website Launch, with the board and its lanes in a sidebar and the Cards section showing Card body preview, Due soon, Short ID and Move receipts. The Board Settings window for Website Launch, with the board and its lanes in a sidebar and the Cards section showing Card body preview, Due soon, Short ID and Move receipts. The Board Settings window for Website Launch, with the board and its lanes in a sidebar and the Cards section showing Card body preview, Due soon, Short ID and Move receipts.

The window also has a page for each lane. Lane Settings… in a lane’s menu opens it. See Lanes.

Move receipts adds one quiet line to a card’s comments when you move the card to another lane on the same board. It says from where, to where, when and by whom. The “by” part is left out if your Mac account has no full name. Moving a card across boards, copying it, sending it to the trash and restoring it leave no line. Undoing the move removes the line. A move made by the Shortcuts Move Card action leaves one too. It is off until you turn it on.

  1. Choose Board ▸ Board Settings….
  2. In the Cards section, switch on Move receipts.

The setting takes effect at once and belongs to this board. A receipt never clears a waiting flag. For how a receipt is stored, see Move receipts, and for the setting’s key, Move receipts.

The Label Kinds section is where a board’s label kinds are made and changed. See Labels for what kinds are for.

  1. Select a kind in the list, or choose New Kind to add one.
  2. Set its Name, Icon and Colour. The Type is made from the name and is fixed once saved.
  3. Choose whether Values is Any value or A fixed list. For a fixed list, add values and drag them into rank order.
  4. Choose One per card if a card can carry only one value of the kind.
  5. Choose Save, or Cancel to drop the draft.

Saving changes only the board’s definitions. Cards keep the labels they already carry, and Save cannot be undone. Remove Kind… and removing a value ask first, and say how many cards still carry it. The built-in text kind can be renamed and recoloured but never removed. Reset to Built In puts it back.

For the keys these settings write, see Labels in depth and Configuration.

Choose View ▸ Appearance, or the Appearance button in the toolbar, then Auto, Light or Dark. Auto follows macOS. The choice applies to every Lanework window.