Skip to content
This repository has been archived by the owner on Sep 3, 2018. It is now read-only.

Filters

Martin Gill edited this page Apr 23, 2014 · 5 revisions

This page discusses some of the filtering capabilities.

General

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.

Saving Filters

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.

Filter entities

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

Due Dates

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.

Meta-Data

Use simple text filters to find a specific meta-data entry, e.g. meta:data, or key:value.

Special Filters

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
Clone this wiki locally