Manual · Using tagwerk
Widgets and sharing (Android)
Put today's tasks and appointments on the Android home screen, act on a task from the widget, capture a new task with one tap, and share text from other apps into today's note.
Android only
Everything in this chapter exists in the Android app only - in the Google Play version and in the version without Google. Windows and Linux have no widgets and no share target.
tagwerk brings two home-screen widgets:
| Widget | Size | What it does |
|---|---|---|
| tagwerk - Today | 4 x 2 cells, resizable | Lists overdue tasks, today's appointments and today's tasks. A tap on a row opens a card for that task or appointment. |
| tagwerk - New task | 1 x 1 cell | One tap opens today's note with a new task line. |
The plain Today widget, the card, New task and sharing are free. Setting up what a Today widget shows is part of tagwerk Pro.
Adding a widget
- Long-press an empty spot on the home screen and choose the launcher's widgets.
- Find tagwerk and drag tagwerk - Today or tagwerk - New task onto the home screen.
- Depending on the launcher, tagwerk opens the new widget's settings right away. Without Pro you only close them again; the widget shows its default view.
Two settings apply to all widgets and are in Settings → Home screen & system:
- Appearance: System, Light or Dark, independent of the app's own appearance. With System the widgets follow a switch of the phone's dark theme a few seconds later when it is switched by hand, and at the start and end of a custom schedule; with Sunset to sunrise they follow at their next redraw, or when tagwerk is opened.
- On the home screen lists every placed Today widget with a short summary. Tap one to set it up. No widgets yet. Place one from the home screen, then it can be set up here. means there is none.
The Today widget
Without any setup, the widget shows the profile that is open in the app, in this order:
- Overdue tasks from earlier days, in amber.
- Today's appointments, time first. Appointments whose time has passed drop off.
- Today's open tasks, high priority first, then normal, then low.
A fine line separates these blocks. The title row names the day and, on the right, counts the overdue tasks (▲ 3).
What a row shows:
- A task starts with an empty box; a task in progress (
[/]) with a half-filled one. The box is amber for high priority, green for normal and blue for low. - A task with sub-tasks shows how far its checklist has come, such as
2/4. - Tags and contacts are coloured as in the app. Bold, code and struck-through text are drawn, not spelled out.
With nothing left to do, the widget says No open tasks.
On Android 12 and newer the list scrolls. On older versions the widget shows a fixed number of rows and ends with +n for the rest.
Where a tap leads: a row opens the card for that task or appointment. The title row and empty space open the app on today - on a widget set to a profile, in that profile.
How it stays current: the widget is updated whenever a note changes and again at midnight. If the app has not been opened for a while and the widget has no data for the current day, it says Open the app to refresh. Overdue tasks are still shown, because they stay overdue whatever the day.
Several days: a widget set up to show more than one day, or to start on a later day, puts a heading over each day with its date and how far off it is, such as in 2 days. The overdue tasks stand under Overdue.
The card behind a row
A tap on a task row opens a card over the home screen. You can finish the task there without opening the app.
- At the top: the task as the row showed it, its day, and the first lines of its description. The arrow unfolds the full description; a long press copies it. Links in it can be tapped.
- Done, Drop and In progress set the task's state in the note. Where two tags or more wait for a reading, Enter readings only joins them, and the four stand two by two (Readings).
- Move to day offers Today, Tomorrow, Day after tomorrow and the same weekday next week. Another day opens every day of the coming week, then 14 days, 1 month, 3 months, 6 months and 1 year, and Another date... for any date. Back returns to the card.
- Open in app opens the task's day in the app.
The card writes the note directly. If the task was changed or moved in the meantime, the card says so and changes nothing, for example This task has already been done. If only the wording changed, it shows the new text and offers Continue with this task.
Ticking off, dropping, moving and repeating follow the same rules as in the app; see Tasks.
Sub-tasks on the card
A task's checklist stands on the card under the description. Tap a sub-task to tick it off, tap again to open it again. The card stays open, so you can work through the whole list. Finished sub-tasks fold away behind Show 2 settled; Hide settled sub-tasks folds them again.
Readings on the card
If a tag of the task is waiting for a reading, such as #weight:, Done asks Enter readings first, with one field per tag and the last value as a hint. Save writes the values and finishes the task; Cancel returns to the card and the task stays open. The rules are in Tags and search.
Appointments on the card
A tap on an appointment row opens a card for that one occurrence:
- Another time moves it to another hour.
- This one is off calls it off.
- Move to day and Another day move it to another day.
How this works with repeating appointments is described in Appointments. An occurrence that is already called off opens the app instead.
Setting up a Today widget
Each Today widget has its own settings. Open them from Settings → Home screen & system → On the home screen, or from the launcher's widget settings where it offers them. Change what you need and tap Save.
| Section | What you set |
|---|---|
| Time range | How many days the list covers: Today, 2d, 7d, 14d, 30d, or Other for any number up to 365. Overdue tasks always appear, whatever is set here. |
| Show from | The first day of the list: Today, Tomorrow, Day after tomorrow, 7d, or Other. A list that starts later leaves the overdue tasks out - a widget for the days ahead. |
| Profile | From the second profile on: which profile the widget shows. The widget keeps showing this profile, whichever one the app has open. |
| Title | Date, Own title (for example "Office") or No title. Without a title there is room for one more row; the overdue counter goes with the title row. |
| Font | Sans-serif or Monospace. Rows do not wrap, so monospace shows less of each line. |
| Background | How solid the widget's background is, from 0 to 100 %. The text keeps its colours. |
| Filter | Tags and contacts. One tap selects a tag, a second excludes it, a third clears it. Without a filter the widget shows everything. |
| Content | Show appointments, Show tasks (at least one of the two stays on), Hide appointments that have passed, Show cancelled appointments, Colour box at the start of the row, Tags in their own colour, Divide the blocks with a line, Show tags, Show contacts. |
| Sub-tasks | Show sub-tasks puts a task's sub-tasks into the list as indented rows of their own. The ▲ counter does not count them. |
A sub-task counts for the filter with the tags and contacts of the tasks it is indented under, as in the task list: excluding a tag removes a task together with its sub-tasks.
The filter also applies to appointments: an appointment matches when its line contains the tag or the contact. If your appointments carry no tags, switch on Show appointments regardless of the filter, which appears under Content while a filter is set. The colour box needs Android 12 or newer; the coloured tags work everywhere. Both use the tag colours of the profile.
Quick capture
A tap on tagwerk - New task opens today's note with a new empty task line, - [ ] , and the cursor behind it. Type the task and leave the app.
- If today's note has headings, or would get them from its day template, tagwerk first asks Under which heading?. Pick one, or At the end of the note.
- If an empty task line is already waiting there, the cursor goes to it instead of writing a second one. A tap by mistake leaves nothing behind.
The new line goes into the profile that is open in the app.