Return to site

Taskpaper 3 7 5 – Simple To Do List

broken image


TaskPaper 3.8.10 – Feb 13, 2020 Download

  • TaskPaper 3.7.6 – Simple to-do list. February 27, 2018. TaskPaper is a plain-text to-do list that's surprisingly adept. Thoroughly modernized. TaskPaper 3 is all new, while still retaining the same plain-text design that's been getting things done since 2006. What's New in 3.
  • TaskPaper 3.7.5 – Simple to-do list. November 12, 2017. TaskPaper is a plain-text to-do list that's surprisingly adept. Thoroughly modernized. TaskPaper 3 is all.

Feb 19, 2019 Below, we've compiled a list of the best to-do apps available, so you can compare them quickly and choose one that's right for you. Make simple to-do lists with TaskPaper With TaskPaper, you can make plain text lists of everything important to you, which will also be easily editable anywhere. TaskPaper also supports due dates. For these, you simply use a tag with the date within parentheses. For example, @due(1970-01-01) would set a task due Thursday, January 1, 1970. This date would be in the past, so it won't do you much good, but it works as an example. Feb 26, 2008 TaskPaper: A Deceptively Simple To-Do List Posted in GTD, productivity, To Do List Applications by jquig99 on February 26, 2008 A few months ago I received an email asking me to check out this new to-do list application, TaskPaper.

  • Fixed crash on start that was effecting some users
  • Changed to standard drag and drop behavior unless dragging items

TaskPaper 3.8.8 – Feb 8, 2020 Download

  • Fixed Tag > Remove Tags command
  • Fixed Tag > Tag With… to not include values
  • Fixed Edit > Insert Date 'now' to use minutes instead of milliseconds resolution
  • Added TaskPaper preference allowing sidebar size to follow System Preferences > General > Sidebar Icon Size setting

TaskPaper 3.8.6 – Jun 13, 2019 Download

  • Fixed sidebar to display tag value lists such as @priority(1, 2, 3)
  • Fixed crash when tag name matched another tag-value name. For example @a(a) and @a-a

TaskPaper 3.8.5 – May 5, 2019 Download

  • TaskPaper is now notarized by Apple to increase security
  • Fixed tab titles to include focused project name (requres macOS 10.13 or later)
  • Removed debugger statement from javascript code
  • Updated to Swift 5

TaskPaper 3.8.4 – Feb 5, 2019 Download

  • Tag values in sidebar are ordered by name
  • Replace all is now stored under single undo grouping
  • Should no longer be asked for keychain password when updating

TaskPaper 3.8.3 – Jan 9, 2019 Download

  • Fixed incorrect search when selecting tag value in sidebar
  • Fixed invalid searches when clicking on tag values that include search syntax by quoting all values

TaskPaper 3.8.2 – Nov 15, 2018 Download

  • Updated licensing framework
  • Fixed crash that could happen when archiving items
  • Fixed bug where some stylesheet attributes were not applied to editor
  • Fixed performance bug the caused long delay when using accessibly API in long documents
  • Fixed case where empty line leading tab indentation was lost when document saved and reloaded

TaskPaper 3.8.1 – Oct 1, 2018 Download

  • Fix bug where it wasn't possible to drag file links into TaskPaper document.

TaskPaper 3.8 – Sep 19, 2018 Download

  • Added support for macOS Mojave
  • Added option to 'Import Reminder Copies'
  • Added dark mode support to TaskPaper stylesheets
  • Fixed sorting of Window > Stylesheet list
  • Fixed text blurriness that could occur when focus-in and focus-out
  • Fixed bug where option-click on item handle would focus wrong item

Taskpaper 3 7 5 – Simple To Do List Words

TaskPaper 3.7.7 – Jul 1, 2018 Download

  • Added View > Show Sidebar And Expand Completely
  • Fixes print margins to be smaller
  • Fixes 'sentence' command spelling
  • Fixes crash that could occur when using ancestor-or-self:: in search
  • Fixes undo bug where undoing moves might put items at wrong indentation
Taskpaper 3 7 5 – Simple To Do List

TaskPaper 3.7.6 – Nov 21, 2017 Download

  • Adds support for tag value lists.

TaskPaper allows you to create tags by typing @ followed by a tag name. You can also include an optional value after the tag like this: @mytag(my value).

The new feature is that TaskPaper now understands lists of comma separated values. For example you can now type @job(jack,jane) and TaskPaper understands that there's a list of values associated with the tag. When you click on 'jack' your lists will be filtered to show all tasks where 'jack' is listed on the job.

TaskPaper 3.7.5 – Nov 10, 2017 Download

  • Added warning that imported reminders are removed from Reminders.app
  • Added warning when trying to work with Reminders.app without access granted
  • Fixed keyboard focus problem when closing searchbar
  • Fixed problems styling and updating searchbar

TaskPaper 3.7.4 – Aug 14, 2017 Download

  • Added TaskPaper > Recover License to direct download version
  • Fixes crash that could occure when placing cursor in empty line

TaskPaper 3.7.3 – Jun 8, 2017 Download

  • Fixes copying of last item in a filtered view
  • Fixes comparing against empty string ('') in search syntax

TaskPaper 3.7.2 – May 11, 2017 Download

  • Fixes crash that could happen when opening new documents.

TaskPaper 3.7.1 – Apr 28, 2017 Download

  • Fixes a auto-save bug where changes in last line of text might not save.

TaskPaper 3.7 – Apr 27, 2017 Download

TaskPaper 3.7 improves how filtered items work in two ways:

  1. Filtered items are now selected only when a visible ancestor item is also selected.
  2. It's now easier to see when you've selected filtered items so you don't accidentally delete them.

Also this release:

  • Remembers and restores which outline items are expanded in sidebar
  • Fixed crash when pasting text that contained non 'n' newline characters
  • Fixed crash when option (to create copy) dragging items from one document to another

TaskPaper 3.6.2 – Jan 23, 2017 Download

  • Item > Move to Project no longer moves the selection along with the moved project
  • When moving items in a filtered view don't reveal hidden items when performing the move
  • Fixed Pasting page break character no longer crashes TaskPaper
  • Fixed Clicking file links in Mac App Store version new reveals files in Finder
  • Fixed Edit > Selection > Select Sentence to not select the trailing newline after the sentence
  • Fixed unwanted scrolling that could occur when (Shift-Tab) moving items to the left
  • Fixed no longer autocomplete when inserting @ within existing words

TaskPaper 3.6.1 – Jan 18, 2017 Download

  • Better detection (and distinction) between click and drag on item handles
  • Changed to only show projects in sidebar when all ancestors items are also projects
  • Changed DateTime formatting term 'week' to refer to ISO week (starts on Monday instead of Sunday)
  • Fixed Tag > Tag With to only add leading space before added tag when needed
  • Fixed broken File > Revert To > Browse All Versions views
  • Fixed poor performance on new MacBooks with Touch Bar
  • Fixed crash when importing reminders with newlines in titles
  • Fixed crash when loading malformed stylesheet

TaskPaper 3.6 – Nov 15, 2016 Download

Reminders: Quickly import items from (or export to) Reminders.app. Create reminders on the go with Siri then move them into TaskPaper at your Mac. Or export TaskPaper items to Reminders on your Phone.

Palettes: Create new items or select multiple items from the standard palette UI. Use Edit > Tag With… to apply multiple tags at once. Use Item > Move to Project… to both create a new project and move items to it in a single step.

  • Added Edit > Insert Date…
  • Added File > Import Reminders… to import from Reminders.app
  • Added Item > Export to Reminders… to export items to Reminders.app
  • Tag > Tag With… prompts for date when tagging with @due and @start
  • Edit > Find commands now work when sidebar has focus, redirecting focus to editor
  • Removed category text for each command when showing command palette
  • Maintain focus item and search when open TaskPaper file is modified by another app
  • Removed unused font, color, orientation items from editor context menu
  • Fixed iCloud Drive to include TaskPaper folder
  • Fixed Refresh of 'Hoisted' item search works correctly
  • Fixed Date parsing to support ISO week and day formats like 2016-W51-4
  • Fixed top-padding-percent stylesheet attribute
  • Fixed scrollbar jumping in cases involving wrapped lines
  • Fixed search case where union, intersect, and except caused problems
  • Fixed problem in palettes where filtering could place items in wrong group

TaskPaper 3.5.1 – Oct 13, 2016 Download

Taskpaper 3 7 5 – Simple To Do List

TaskPaper 3.7.6 – Nov 21, 2017 Download

  • Adds support for tag value lists.

TaskPaper allows you to create tags by typing @ followed by a tag name. You can also include an optional value after the tag like this: @mytag(my value).

The new feature is that TaskPaper now understands lists of comma separated values. For example you can now type @job(jack,jane) and TaskPaper understands that there's a list of values associated with the tag. When you click on 'jack' your lists will be filtered to show all tasks where 'jack' is listed on the job.

TaskPaper 3.7.5 – Nov 10, 2017 Download

  • Added warning that imported reminders are removed from Reminders.app
  • Added warning when trying to work with Reminders.app without access granted
  • Fixed keyboard focus problem when closing searchbar
  • Fixed problems styling and updating searchbar

TaskPaper 3.7.4 – Aug 14, 2017 Download

  • Added TaskPaper > Recover License to direct download version
  • Fixes crash that could occure when placing cursor in empty line

TaskPaper 3.7.3 – Jun 8, 2017 Download

  • Fixes copying of last item in a filtered view
  • Fixes comparing against empty string ('') in search syntax

TaskPaper 3.7.2 – May 11, 2017 Download

  • Fixes crash that could happen when opening new documents.

TaskPaper 3.7.1 – Apr 28, 2017 Download

  • Fixes a auto-save bug where changes in last line of text might not save.

TaskPaper 3.7 – Apr 27, 2017 Download

TaskPaper 3.7 improves how filtered items work in two ways:

  1. Filtered items are now selected only when a visible ancestor item is also selected.
  2. It's now easier to see when you've selected filtered items so you don't accidentally delete them.

Also this release:

  • Remembers and restores which outline items are expanded in sidebar
  • Fixed crash when pasting text that contained non 'n' newline characters
  • Fixed crash when option (to create copy) dragging items from one document to another

TaskPaper 3.6.2 – Jan 23, 2017 Download

  • Item > Move to Project no longer moves the selection along with the moved project
  • When moving items in a filtered view don't reveal hidden items when performing the move
  • Fixed Pasting page break character no longer crashes TaskPaper
  • Fixed Clicking file links in Mac App Store version new reveals files in Finder
  • Fixed Edit > Selection > Select Sentence to not select the trailing newline after the sentence
  • Fixed unwanted scrolling that could occur when (Shift-Tab) moving items to the left
  • Fixed no longer autocomplete when inserting @ within existing words

TaskPaper 3.6.1 – Jan 18, 2017 Download

  • Better detection (and distinction) between click and drag on item handles
  • Changed to only show projects in sidebar when all ancestors items are also projects
  • Changed DateTime formatting term 'week' to refer to ISO week (starts on Monday instead of Sunday)
  • Fixed Tag > Tag With to only add leading space before added tag when needed
  • Fixed broken File > Revert To > Browse All Versions views
  • Fixed poor performance on new MacBooks with Touch Bar
  • Fixed crash when importing reminders with newlines in titles
  • Fixed crash when loading malformed stylesheet

TaskPaper 3.6 – Nov 15, 2016 Download

Reminders: Quickly import items from (or export to) Reminders.app. Create reminders on the go with Siri then move them into TaskPaper at your Mac. Or export TaskPaper items to Reminders on your Phone.

Palettes: Create new items or select multiple items from the standard palette UI. Use Edit > Tag With… to apply multiple tags at once. Use Item > Move to Project… to both create a new project and move items to it in a single step.

  • Added Edit > Insert Date…
  • Added File > Import Reminders… to import from Reminders.app
  • Added Item > Export to Reminders… to export items to Reminders.app
  • Tag > Tag With… prompts for date when tagging with @due and @start
  • Edit > Find commands now work when sidebar has focus, redirecting focus to editor
  • Removed category text for each command when showing command palette
  • Maintain focus item and search when open TaskPaper file is modified by another app
  • Removed unused font, color, orientation items from editor context menu
  • Fixed iCloud Drive to include TaskPaper folder
  • Fixed Refresh of 'Hoisted' item search works correctly
  • Fixed Date parsing to support ISO week and day formats like 2016-W51-4
  • Fixed top-padding-percent stylesheet attribute
  • Fixed scrollbar jumping in cases involving wrapped lines
  • Fixed search case where union, intersect, and except caused problems
  • Fixed problem in palettes where filtering could place items in wrong group

TaskPaper 3.5.1 – Oct 13, 2016 Download

  • Fixed Bug in 2-Set Korean input method
  • Fixed Crash when editing stylesheet in VIM
  • Fixed Crash when archiving first visible item
  • Fixed Add checkmark to View > Show Sidebar when it's visible
  • Fixed Item > Move to Project to insert item at start of project's items

TaskPaper 3.5 – Oct 11, 2016 Download

Due to changes in TaskPaper's bundle identifier TaskPaper 3.5 cannot auto-update itself. You will need to download again directly from using the following link. This is a free update, just re-enter your existing license key if prompted.

App

  • New Icon, thanks @sdw!
  • New Code, rewrote native layer in Swift 3
  • New Requirements, now requires OS X 10.11 or later

Sidebar

  • Added Projects, Searches, and Tags sections
  • Ability to Show/Hide sidebar sections
  • Ability to Expand/Collapse Individual Projects
  • Double-click on project in sidebar to 'hoist', show only it's descendants
  • Tags configuration file, allowing you to choose tags shown/hidden in the sidebar
  • Searches configuration file, allowing you to choose searches shown in the sidebar
  • Context menu (and main menu) items for creating, editing, and deleting saved searches
  • Saved searches may be embedded in current document, or saved separately

Searchbar

  • Larger, can more easily display complex searches
  • Only shows when active (preference to change this behavior)
  • Attention getting, you should never miss the fact that a search is active (changeable in stylesheet)
  • Much faster search results in large documents with complex search logic

Palettes

  • New Palettes UI, faster keyboard navigation
  • Replaced 'Go to' popup menu's with new palette UI
  • Added 'Go to Anything' Palette
  • Added 'Command palette' with ability to add your own script commands
  • Changed keyboard shortcuts so all palettes use a form of Command-P

Tabs/Windows

  • Ability to open multiple windows (or tabs on macOS 10.12) on a single document
  • Added 'Open in New Window' popup item for sidebar items
  • Added 'Open in New Tab' popup item for sidebar items (macOS 10.12)
  • Reorganized menu items to better fit macOS 10.12's 'Show Tab Bar' item

Stylesheets

  • Ability to switch between stylesheets
  • Each window can now have a different (Window > Style) style
  • Printing panel has it's own separate stylesheet setting
  • Renamed display span stylesheet attribute to content
  • New options including text wrap and typewriter scrolling (see user's guide for details)

Other

  • Added Allow delete backward to un-indent items preference
  • Added Preference to maintain search when select project changes
  • Added Preference to maintain project when select search changes in sidebar
  • Added scripting API to get all OutlineEditors associated with a given outline
  • Removed 'New Document' preferences (spelling, etc), those settings now apply to all documents
  • Changed direct download bundle ID to avoid conflicts with app store version
  • Direct download version recognizes App Store licenses (must run App Store version once first)
  • Improved folded state persistence in documents that are edited outside TaskPaper
  • Improved Drawing of split cursor text insertion point
  • Changed default font to system reported 'user font'
  • Fixed file and icon associations

TaskPaper 3.3.2 – Jul 11, 2016 Download

  • Updated to work on macOS Sierra Beta
  • Disabled dragging the root item from the sidebar
  • Disabled dragging items into the outline view when it is empty
  • Fixed error when dragging into the sidebar when outline view is empty

The release frequency has slowed as I've taken a step back to work on some larger changes.

First, I've just finished restructuring TaskPaper's code so that I'm able to open source the model layer (see links below). This makes it possible for other scripters and developers to process TaskPaper files on macOS, iOS, and anywhere else where there's JavaScript.

Second, I'm now in the process of updating the user interface code to use Apple's new Swift programming language. This will put TaskPaper on a better foundation to keep up with whatever changes Apple brings in the future. It's also giving/forcing me to look through every line of code and fix all the dumb stuff that I did! I'm still a ways from done, but I'm making good progress.

Open Source Model Layer:

TaskPaper 3.3.1 – May 25, 2016 Download

  • Clicking on task dash (to toggle @done) no longer scrolls to selected text

TaskPaper 3.3 – May 19, 2016 Download

Added Expand/Collapse Commands:

  • Added View > Expand Items
  • Added View > Collapse Items
  • Added View > Expand All By Level
  • Added View > Collapse All By Level

Hold down 'Option' key for a 'Completely' variant of each item.

Removed Redundant Commands:

  • Removed View > Fold
  • Removed Items > Indent
  • Removed Items > Un-Indent

Get google drive for desktop. Please use the explicit Expand/Collapse commands for folding. Use 'Tab' and 'Shift-Tab' instead of the Indent and Un-Indent menu items. I think any short term pain this causes will make TaskPaper a more nimble and focused app long term.

Improved Item Movement in Filtered Views:

  1. Moving items should never 'capture' hidden items as children.
  2. No additional items should appear on screen when moving items.

Added New 'filtered' Item Handle State:

This state joins the existing 'Expanded' and 'Collapsed' states. Filtered state indicates that some children are visible and others are filtered out of the display. Click a filtered handle to expand it to show all children.

  1. Expanded – Dim empty circle
  2. Collapsed – Bright filed circle
  3. Filtered – Dim filled circle

Other Changes:

  • Improved alert messaging when opening invalid file links.
  • Fixed leading spaces from being removed from pasted text.
  • Fixed periodic broken 'Tag With…' toolbar popup menu state.
  • Fix crash when inserting new item into empty document.
  • Maintain full line selection when move item to end of list.

Theme Additions:

  • Added filtered item attribute for themes to query.
  • Added handle-size item style property.
  • Added handle-border-color item style property.
  • Added handle-border-width item style property.

TaskPaper 3.2.1 – May 6, 2016 Download

  • Editor better maintains current scroll position when editing.
  • Pasting into end of focused project now inserts items correctly.
  • 'Share Item' in toolbar is fixed to share the the selected text.
  • Don't scroll to selection when performing drag and drop operations.
  • Include 'More…' option in toolbar 'Share Item' popup menu.
  • Fixed how leading spaces are converted into item indent levels.
  • Preview badge now includes version number and isn't shown in notification style.
  • Archive Done command now includes all containing projects in @projects tag.
  • Use 'TaskPaper Generic' file type to save without .taskpaper file extension.
  • Fixed problem where text caret would display in wrong position or not at all.
  • Search field text on OS X 10.10 no longer remains centered after clicking tag.
  • Return only autocompletes to formatted tasks when current line starts with - .
  • Delete last item then followed by Undo and then Redo no longer causes crash.
  • Selection now draws correctly behind paragraph break invisible characters.
  • Edit > Copy Displayed (Option-Command-C) works when last item is fully selected.

TaskPaper 3.2 – Apr 22, 2016 Download

  • Added header and footer printing options to print panel.
  • Track expanded/collapsed state in extended file attribute.
  • Edit > Copy Displayed (Option-Command-C) for only displayed items.
  • Added right margin padding to balance default left margin padding.
  • Escape in empty toolbar search field shows recent searches menu.
  • Control-Tab and Shift-Control-Tab now move focus of toolbar search field.
  • ShowPreviewBadge defaults key to hide 'Prev' badge in TaskPaper's preview version.
  • Tag autocompletions are now case insensitive.
  • Tag autocompletions only popup when editing at end of tag.
  • Move 'Saved Searches' to top of toolbar search field popup.
  • Require that both ( and ) be escaped with when used in tag values.
  • Apply tag and similar commands only effect displayed items, not collapsed or filtered.
  • Hidden items with no visible ancestor are no longer effected by edits.
  • It's now possible to fully select the last displayed item, so you can cut/copy its collapsed items.
  • Changed script debug process, see user guide 'Creating Scripts' section.
  • Renamed theme ‘display' text style attribute to ‘content'.
  • Items > Format As to work when item is a project with trailing tags.
  • Document name (instead of always 'Untitled') now displays in printed header.
  • Guide lines now draw for items with hidden parents but visible ancestors.
  • Escape in toolbar search field clears text without losing focus.

Scripting API

  • Outline.getOutlines()
  • OutlineEditor.getOutlineEditors()
  • OutlineEditor.getOutlineEditorForOutline(outline)
  • selection.selectedItems
  • selection.displayedSelectedItems
  • selection.displayedAncestorSelectedItems

TaskPaper 3.1 – Apr 1, 2016 Download

  • Added TaskPaper > Show License menu item.
  • Added Help > Email, FAQ and Release Notes items.
  • Added Hold down shift to drop items 'on' other items.
  • Added Drag and drop projects in sidebar to reorder.
  • Added Saved searches to search field Recents menu.
  • Added Drop text, URLs, etc into sidebar.
  • Changed 'Move to Project' to add at top of list.
  • Changed Drop on sidebar to add at top of list.
  • Changed Default theme to hide handles of empty items.
  • Changed Use document filename as label instead of 'Home'.
  • Changed Don't show saved search when search text is empty.
  • Changed Command-L (Go to Project…) to always use popup. Use Control-Shift-Tab for sidebar.
  • Changed Option-click on item handle now focuses item instead of only its children.
  • Changed Don't show @ before tag names in menu items, so type to select works better.
  • Fixed (another) incorrect selection when using Option-Return.
  • Fixed Do nothing when drag and drop item to original location.
  • Fixed projects popup to removing trailing tags.
  • Fixed Strip trailing tags and : from Archive Done project name.
  • Fixed Printing to always print same view that you see (even when searching).

Theme Additions:

  • Added depth item attribute for themes to query:
  • Added paragraph-spacing-before item style property.
  • Added paragraph-spacing-after item style property.
  • Added guide-line-width editor style property.
  • Added item-handle-size editor style property.

Theme Additions Demo:

TaskPaper 3.0.1 – Mar 23, 2016 Download

  • Fixed Click on Home in the sidebar will now clear any active searches.
  • Fixed Delete will now scroll text caret to visible if it's not already visible.
  • Fixed Incorrect text caret position when using Option-Return to create a new item.
  • Fixed Better maintain scroll position when editing the outline.
  • Fixed Crash when reloading a theme soon after closing a document.
  • Fixed Crash when loading a theme with syntax errors.
  • Fixed Single pixel wide sidebar on OS X 10.10.

TaskPaper 3 – Mar 16, 2016 Download

  • All new modernized app
  • Flexible and unique folding UI
  • More powerful outliner and text editor
  • Saved searches; one click away in sidebar
  • Relative date and time based searches
  • More powerful hierarchical searches
  • LESS/CSS powered themes
  • Extensive Javascript API

Historical

Download old and unsupported versions of TaskPaper. Affinity designer 1 5 4 – vector graphic design software.

Browse

An opinionated todo-list plugin for Sublime Text editor (version 2 and 3)

Details

Installs

  • Total178K
  • Win92K
  • Mac52K
  • Linux34K
Oct 18Oct 17Oct 16Oct 15Oct 14Oct 13Oct 12Oct 11Oct 10Oct 9Oct 8Oct 7Oct 6Oct 5Oct 4Oct 3Oct 2Oct 1Sep 30Sep 29Sep 28Sep 27Sep 26Sep 25Sep 24Sep 23Sep 22Sep 21Sep 20Sep 19Sep 18Sep 17Sep 16Sep 15Sep 14Sep 13Sep 12Sep 11Sep 10Sep 9Sep 8Sep 7Sep 6Sep 5Sep 4Sep 3
Windows112101714241491124231920181012161120172712815182620218519161118179111925152519861422
Mac036817119219595125641588932761157548109811649121413625117
Linux235710584787128961859612646494834646994459410142545

Readme

Source
raw.​githubusercontent.​com

PlainTasks

An opinionated todo-list plugin for Sublime Text (2 & 3) editor

Installation

To install this plugin, you have two options:

  1. If you have Package Control installed, simply search for PlainTasks to install.

  2. Clone source code to Sublime Text packages folder.

Start a new todo-list

Bring up the command palette (it's ⌘ + shift + p in OS X and ctrl + shift + p in Windows) and type task and select Tasks: New document command.

NOTE: Save your todo files with todo, todolist, tasks or taskpaper file extensions or just name them TODO with no extension.For more portability you can use todolist.txt either as a filename or as suffix for any arbitrary filename.

Usage

NOTE: In Windows or Linux use ctrl instead of

⌘ + enter or ⌘ + i: new task

⌘ + d: toggle task as completed.

ctrl + c: toggle task as cancelled on Mac. alt + c on Windows/Linux.

⌘ + shift + a will archive the done tasks, by removing them from your list and appending them to the bottom of the file under Archive project

Casino marker definition. ☐ ⌘ + shift + o will archive in Org-Mode style, removing the entire subtree after cursor and appending it to new file next to original one, e.g. if original is filename.TODO then new would be filename_archive.TODO

⌘ + shift + u will open the url under the cursor in your default browser, other than http(s) schemes must be enclosed within <>, e.g.

☐ Anything with colon at the end of the line is a project title, you can also nest projects by indenting them.

☐ You can write plain text as notes or descriptions wherever you want. Use _ or * for italic and bold just like in Markdown.

☐ You can add tags using @ sign
You can place cursors on tags, click right mouse button and Filter by tags under cursors:pending tasks with selected tags will remain visible (and their notes and projects they belong to), but everything else will be hidden/folded; to unfold all press ⌘+k, ⌘+j or ⌘+k, ⌘+0

☐ You can navigate tags in current document via ⌘+shift+r.

☐ PlainTasks comes with a simple snippet for creating separators, if you feel that your task list is becoming too long you can split it into several sections (and fold some of them) using this snippet:

-- and then tab will give you this: --- ✄ -----------------------

☐ Completion rules (ctrl+space or alt+/ to see list of them):

  • type t, press tab — it'll become @today — this one is highlighted differently than other tags;
  • c, tab@critical;
  • h, tab@high;
  • l, tab@low;
  • s, tab@started — press tab again and current date will be inserted, when you'll complete or cancel a task with such tag, you'll know how many time has passed since start; if you have to change done/cancelled/started time, then you can recalculate the time spent on task by pressing tab while cursor is placed on a tag;
  • tg, tab, tab work in the same manner as s, but inserts @toggle(current date) — so you can pause and resume to get more correct result when done/cancel; each toggle tag is either pause or resume depending on its place in sequence;
  • cr, tab, tab@created(current date) (⌘ + shift + enter creates a new task with this tag);
  • d, tab@due( )
    If you press tab again, it'll insert current date, same for @due( 0).
    You can type short date (similar to OrgMode's date prompt, but not the same) and then press tab to expand it into default format.
    Short date should be _@due(year-month-day hour:minute)__
    Dot can be used instead of hyphen, but should be consistent _year.month.day

    • year, month, minute, hour can be omitted:

      Notation Meaning
      @due(1) 1st day of next month always
      @due(--1) 1st day of current month always
      @due(5) 5th day of current month (or next month if current day is 5th or older)
      @due(2-3) February 3rd of current year or next one
      @due(31 23:) 31st day of current/next month at 23 hours and minutes are equal to current moment
      @due(16.1.1 1:1) January 1st of 2016 at 01:01 @due(16-01-01 01:01)
    • relative period of time starts with a plus sign or two
      __+[+][number][DdWw][h:m]__ — number is optional as well as letter d for days or letter w for weeks.

      Notation Meaning
      @due(+) tomorrow as well as @due( +1) or @due( +1d)
      @due(+w) one week since current date, i.e. @due( +7)
      @due(+3w) 3 weeks since current date, i.e. @due( +21d)
      @due(++) one day since @created(date) if any, otherwise it is equal to @due(+)
      @due(+2:) two hours since current date
      @due(+:555) 555 minutes since current date
      @due(+2 12:) 2 days and 12 hours since current date

☐ You can create a link to a file within your project by prefixing the file name with a dot and (back)slash like: .filename or ./another filename/.
The line and column can be specified by colons: .filename:11:8.
In SublimeText 3 you can specify a symbol inside that file by using > character like: .filename>symbol.
In SublimeText 2 you can specify a text inside that file by using inch characters like: .filename'any text'.
Pressing ctrl + o (alt + o on Windows/Linux) will open the file in Sublime and scroll to specific position if any.
Also in SublimeText 3 link may point to directory, open such link will add the directory to current project (sidebar).
In addition, Markdown and 'wiki' (Org-Mode, NV, etc.) styles are supported as well, examples:

☐ To convert current document to HTML, bring up the command palette ⌘ + shift + p and type Tasks: View as HTML — it will be opened in default webbrowser, so you can view and save it.
Tasks: Save as HTML… ask if you want to save and if yes, allow to choose directory and filename (but won't open it in webbrowser).

Editor Useful Tools:

☐ Use ⌘ + control + up/down (ctrl + shift + up/down on Windows) to move tasks up and down.

Taskpaper 3 7 5 – Simple To Do List Add

☐ Use ⌘ + r to see a list of projects and quickly jump between them

★ See the Tutorial for more detailed information.

Settings

PlainTasks is an opinionated plugin, which means that it is highly configured to look in a specific way, but this does not mean that you can not customize it. If you feel that something does not look right and you want to change it, you can easily do it in your user settings file.

Go to Preferences → Package Settings → PlainTasks and open Settings - User, there you can override all the default settings, to get an idea you can take a look at Settings - Default.

Here is a list of PlainTasks' specific settings:

SettingDefaultOptions/Description
open_tasks_bullet-[ ]
done_tasks_bullet+[x]
cancelled_tasks_bulletx[-]
date_format(%y-%m-%d %H:%M)See strfti.me for quick reference; detailed documentation: ST2, ST3
done_tagtrueDetermines whether done tasks should gain a @done tag or not
done_datetrueDetermines whether done tasks should gain a date or not
before_tasks_bullet_margin1Determines the number of spaces (default indent) before the task bullet
project_tagtruePostfix archived task with project tag, otherwise prefix
archive_nameArchive:Make sure it is the unique project name within your todo files
new_on_toptrueHow to sort archived tasks (done_tag=true and default date_format are required)
header_to_taskfalseIf true, a project title line will be converted to a task on the certain keystroke
decimal_minutesfalseIf true, minutes in lasted/wasted tags will be percent of hour, e.g. 1.50 instead of 1:30
tasks_bullet_spacewhitespace or tabString to place after bullet, might be any character(s)
highlight_past_duetrueIf true, highlight past, soon, and invalid @due(something)
highlight_due_soon24Hours as int, threshold to define which @due will be soon
scope_past_duestring.other.tag.todo.criticalAny scope, define color for past @due
scope_due_soonstring.other.tag.todo.highAny scope, define color for @due will be soon
scope_misformattedstring.other.tag.todo.lowAny scope, define color for @due mismatch date_format
icon_past_due'circle'Gutter icon¹
icon_due_soon'dot'Gutter icon¹
icon_misformatted'Gutter icon¹
icon_critical'Gutter icon¹
icon_high'Gutter icon¹
icon_low'Gutter icon¹
icon_today'Gutter icon¹
show_remain_duefalseIn Sublime 3, show remain or overdue time under due tags
show_calendar_on_tagsfalseIn Sublime 3, if true, automatically show date picker when cursor is on tag (you can get date picker any time via context menu)
due_preview_offset0Place preview date outside of parens of @due(), 1 — within
due_remain_format'{time} remaining'{time} will be replaced with actual value
due_overdue_format'{time} overdue'{time} will be replaced with actual value

¹ Icon value can be 'dot', 'circle', 'bookmark', 'cross', ', or custom relative path to existing png file,e.g. 'Packages/User/my-icon.png'.

Changing color scheme

If you don't like colors used in bundled schemes just copy any .hidden-tmTheme from PlainTasks to your User directory, change colors and paste the code below in your user settings file:

N.B., sometimes you have to restart Sublime Text to apply changes made in tmTheme file.

N.B., scope_past_due, scope_due_soon, and scope_misformatted settings can assign any scopes defined in tmTheme file, e.g. you can set 'scope_past_due': 'my.own.super.expired.whatever' and then just add style definition in tmTheme for this scope.

Taskpaper Compatibility

If you need to keep your files compatible with Taskpaper, go to Preferences → Package Settings → PlainTasks and open Settings - User, thenadd these settings to the json file:

Spell check

It is build-in feature of Sublime, you can toggle spell check with F6.
For convinience, you may add bullets in list of ignored words into Preferences → Settings - User, e.g.

[BONUS] Custom todo icon

PlainTasks comes with a custom todo icon that you can find in the icons folder. You can assign it to your todo files to give them a better look and distinguish them from other plain text files. Google and find out how to assign a custom icon to a file type in your operating system.

[BONUS] Custom Statistics

Statistics of current file are represented in status-bar, based on stats_format, which is '$n/$a done ($percent%) $progress Last task @done $last' by default — as you can see it's just a string containing special directives (see table bellow) and regular chars.

DirectiveDescription
$oAmount of pending tasks
$dAmount of completed tasks
$cAmount of cancelled tasks
$nSum of completed and cancelled tasks
$aSum of all tasks
$percentRatio of $n to $a
$progressPercent as pseudo graphics (absents if less than 10%)
$lastDate of lastly completed task
{{..}}Return pending/completed/cancelled tasks which matched by regex ..;
e.g. {{@tag}} — amounts of tasks with @tag; or {{@a

So you can customise it as you like, by adding to Settings - User, e.g.

Copy statistics

Bring up the command palette and type Tasks: Copy Statistics.

Additional settings for progress bar

Introduction to PlainTasks Screencast

PlainTasks for other editors

NOTE: These are separate projects, maintained by some awesome developers other than us.- Atom: Tasks plugin- Vim: Plaintasks.vim- Visual Studio Code: To Do Tasks- Visual Studio Code: Todo+

Contributors

You can contribute on github

Inspiration

  • Thanks to Chagel for the iTodo plugin.
  • Thanks to Taskmate for TextMate.
  • Thanks to TaskPaper Mac application from hogbaysoftware.com

License

Copyright 2012-2013 Allen Bargi. Licensed under the MIT License





broken image