Home
A library’s Home is a page of tiles: what you come back to every day — today’s journal entry, the tasks due, the notes you changed last — and buttons for what you do every day.
Home is one of the Features: switched off there, the library has no Home, and a tile of a feature that is off is not drawn.
Where it is
Home is one of the destinations of the navigation: in the phone’s bottom
bar, and in the desktop’s rail (Ctrl/⌘+6, or Go to: Home in the
command palette). Move or hide it in Settings → Navigation, like any
other destination (see settings). A library
still opens where it always did.
On a wide window the tiles sit on a grid of four columns, each tile one to four cells wide and tall. That grid needs the room: Home opens as a tab in the focused pane there (#712), and a pane narrower than the grid falls back to the column. On a phone the tiles stand one under the other, in an order of their own. A tablet, and a phone turned to landscape, get the grid — when the content area is wide enough (640 px): the shape follows the room, not the system. A phone in landscape keeps the phone’s layout around it (the bottom bar, the Home as a screen of its own); only the tiles use the width.
Tiles
- Actions — buttons that run something the app already does, with what it needs set in advance (see actions).
- Today’s journal — the first lines of today’s journal entry; a tap opens it. With no entry yet, Write today’s entry makes it.
- Tasks due — the open tasks of
todo.txt, due soonest first, in the order the Todo tab and the home-screen widget use. Check one off right there; a tap on a task opens the Todo tab. - Events today — today’s events from the library’s
calendar.txt, with the goals that cover the day over them (see journal); a repeating event (recurring events) is there on every day its rule reaches, with its rule in words; a row opens the event’s line, a tap opens the journal. - Recently modified — the notes changed last, newest first, the templates left out: the time for today, the day for older ones.
- Pinned — the notes whose frontmatter says
pinned: true. - Journal calendar — the journal’s month, the days with an entry marked; a tap opens that day.
- Top tags — the twelve tags used most; a tap shows a tag’s notes.
- Random note — a note picked at random, to read again; ↻ picks another.
- Saved search — a query of its own and its first results: words, or
key = valueas in search. - Study — the flashcard decks with cards to study today, the most cards first, and the day’s due and new cards over them; a row opens its deck, Study reviews the first. With nothing due it says so.
The tiles read the library’s index and the task list: they store nothing. While the Home is on screen, a change in the library shows in its tiles; a change made while you were elsewhere is there when you come back.
Actions
An Actions tile is a row of buttons, each one something the app already does with what it needs set in advance:
- New note — from a template or empty, in a folder (with none chosen, where the library’s setting for new notes puts it, see organization), its name and frontmatter fields filled.
- Add task — the task dialog, its
+projectand@contextalready written in. - Open a note.
- Today’s entry — the journal’s.
- Capture web page — into a folder of its own instead of the capture folder (see web capture); with none chosen, into the capture folder, which does not follow the setting for new notes. The library root is not among the choices of either action.
Every value of a new note is Fixed or Ask:
- A fixed value is written as it is, after the template commands in it
run:
{{date}} Meetingis today’s meeting. It may ask a question of its own:{{ask:Topic}}. - An asked value is a question when the button is pressed. Under its box sit the values the library already holds for that frontmatter key, most used first: a tap writes one in, or adds it after a comma.
- A field named like one of the template’s own questions (
Topicfor{{ask:Topic}}) answers that question; any other fills the frontmatter key of that name. - A value lands in the frontmatter as YAML reads it:
3is a number,falsea boolean,[a, b]a list,"007"the text it quotes, and anything else text.tagsis always a list:book, scifiis two tags.
All the questions come in one form — a dialog on a wide window, a sheet
on a phone — and with nothing to ask, the note is made at once. Open
after creating decides whether it opens. A button that asks something
says so with ….
An action keeps the template, folder or note it names by path: a rename or a move follows it. One whose template or note is gone is marked on its button, and pressed it says what is missing; restoring the note from the trash mends it. A folder that is gone is simply made again.
To set the buttons, Edit home and the tile’s ⚙: drag to reorder, the bin to remove, a tap to edit one, Add action for another.
Every action of the Home on show is also in the command palette: type its name, and Home: Meeting… runs it from anywhere, the Home’s tab hidden or not. An action has no keyboard shortcut of its own.
Editing the Home
On a wide window, Edit home at the top right turns the grid into its editor, with the tiles to add on the right:
- Move a tile by dragging it, resize it by dragging its corner. The tile you drop keeps its place; a tile it lands on moves down. Tiles stay on the row you put them on, so a gap stays until you move something into it. On a touch screen, press a tile a moment before you drag it, so a plain swipe still scrolls.
- ⋯ on a tile moves or sizes it one cell at a time, without a pointer.
- ✕ hides a tile. It waits under Hidden in the panel, its settings as they were, and comes back from there.
- Add tiles lists every kind; one a Home shows once is offered only while it has none. A Home can hold several Actions and Saved search tiles.
- ⚙ on a saved search sets its name and its query; on an actions tile, its buttons. With a mouse they open in an inspector in the panel beside the grid, in place of Add tiles, and every change is kept as you make it; its ✕ gives the panel back (#712).
- A right click on a tile gives its menu: its settings, the moves of ⋯, and Hide.
- Reset puts the default Home back, after asking.
On a phone, the ✎ beside the date opens the same Home as a list: a handle to drag each tile up or down, a switch to show or hide it, ⚙ for a saved search’s or an actions tile’s settings, and the tiles to add at the foot. Every change is kept as you make it.
A tile hidden here is hidden on every device. A phone that should show fewer tiles than the desktop uses Only on this device, at the top of either editor: the device keeps its own copy of the Home, starting from the one on screen, and its changes stay there. This library goes back to the library’s Home, after asking, and drops the device’s copy.
Where it is kept
The Home belongs to the library: .niman/home.json, one entry per tile,
so it is the same on every device and travels with
sync. A library whose Home you never changed shows the default
one and keeps no file. A device’s own Home (Only on this device) is
kept on the device, with its other device settings.
A home.json that does not read — a hand edit with a stray comma — shows
the default Home, and is not lost: the next change you make sets it aside
as .niman/home.json.bad on this device before writing the new one, so
you can mend it and put it back.