-
Notifications
You must be signed in to change notification settings - Fork 29
Filters
This page discusses some of the filtering capabilities.
Generally anything you type will act as a filter. The filter acts on the actual text of the todo, therefore if you know the syntax you can easily create filters, for example @home will filter all todos for the "home" context.
When you add a filter, you'll notice that the URL of the page updates to include your filter values.
If you want to save your filters for quick access, just bookmark the new URL. When you open that URL the filters will automatically be applied.
A filter entity is contiguous text that isn't white space. E.g. a filter of hello @home
contains two entities.
Entities are additive, but independent. Therefore a filter of hello world
will find both of the following:
- hello world
- hello happy world
But will not find:
- hello there
- large world
For a specific date you can use simple text filters, e.g. due:2014-01-01
as of version 1.5:
-
isDue:today
- Todos overdue or due today. -
isDue:soon
- Todos due in a couple of days. -
isDue:someday
- Todos due after a couple of days. -
isDue:none
- Todos without a due date.
Use simple text filters to find a specific meta-data entry, e.g. meta:data
, or key:value
.
Some entities have special meanings for filtering. They behave the same as any other entity though when combined.
e.g. -@ +NewProject
will find all Todos for project NewProject that do not have context.
The following filter entities have special meaning:
-
-@
- Todos without a context defined -
-+
- Todos without a project defined