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.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:
- Filtered items are now selected only when a visible ancestor item is also selected.
- 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
, andexcept
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.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:
- Filtered items are now selected only when a visible ancestor item is also selected.
- 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
, andexcept
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 tocontent
- 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:
- Moving items should never 'capture' hidden items as children.
- 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.
- Expanded – Dim empty circle
- Collapsed – Bright filed circle
- 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 withwhen 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.
BrowseAn opinionated todo-list plugin for Sublime Text editor (version 2 and 3)
Details
Installs
- Total178K
- Win92K
- Mac52K
- Linux34K
Oct 18 | Oct 17 | Oct 16 | Oct 15 | Oct 14 | Oct 13 | Oct 12 | Oct 11 | Oct 10 | Oct 9 | Oct 8 | Oct 7 | Oct 6 | Oct 5 | Oct 4 | Oct 3 | Oct 2 | Oct 1 | Sep 30 | Sep 29 | Sep 28 | Sep 27 | Sep 26 | Sep 25 | Sep 24 | Sep 23 | Sep 22 | Sep 21 | Sep 20 | Sep 19 | Sep 18 | Sep 17 | Sep 16 | Sep 15 | Sep 14 | Sep 13 | Sep 12 | Sep 11 | Sep 10 | Sep 9 | Sep 8 | Sep 7 | Sep 6 | Sep 5 | Sep 4 | Sep 3 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 1 | 12 | 10 | 17 | 14 | 24 | 14 | 9 | 11 | 24 | 23 | 19 | 20 | 18 | 10 | 12 | 16 | 11 | 20 | 17 | 27 | 12 | 8 | 15 | 18 | 26 | 20 | 21 | 8 | 5 | 19 | 16 | 11 | 18 | 17 | 9 | 11 | 19 | 25 | 15 | 25 | 19 | 8 | 6 | 14 | 22 |
Mac | 0 | 3 | 6 | 8 | 17 | 11 | 9 | 2 | 1 | 9 | 5 | 9 | 5 | 12 | 5 | 6 | 4 | 15 | 8 | 8 | 9 | 3 | 2 | 7 | 6 | 11 | 5 | 7 | 5 | 4 | 8 | 10 | 9 | 8 | 11 | 6 | 4 | 9 | 12 | 14 | 13 | 6 | 2 | 5 | 11 | 7 |
Linux | 2 | 3 | 5 | 7 | 10 | 5 | 8 | 4 | 7 | 8 | 7 | 12 | 8 | 9 | 6 | 1 | 8 | 5 | 9 | 6 | 12 | 6 | 4 | 6 | 4 | 9 | 4 | 8 | 3 | 4 | 6 | 4 | 6 | 9 | 9 | 4 | 4 | 5 | 9 | 4 | 10 | 14 | 2 | 5 | 4 | 5 |
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:
If you have Package Control installed, simply search for
PlainTasks
to install.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 ass
, 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 letterd
for days or letterw
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:
Setting | Default | Options/Description |
---|---|---|
open_tasks_bullet | ☐ | - ❍ ❑ ■ □ ☐ ▪ ▫ – — ≡ → › [ ] |
done_tasks_bullet | ✔ | ✓ ☑ + [x] |
cancelled_tasks_bullet | ✘ | x [-] |
date_format | (%y-%m-%d %H:%M) | See strfti.me for quick reference; detailed documentation: ST2, ST3 |
done_tag | true | Determines whether done tasks should gain a @done tag or not |
done_date | true | Determines whether done tasks should gain a date or not |
before_tasks_bullet_margin | 1 | Determines the number of spaces (default indent) before the task bullet |
project_tag | true | Postfix archived task with project tag, otherwise prefix |
archive_name | Archive: | Make sure it is the unique project name within your todo files |
new_on_top | true | How to sort archived tasks (done_tag=true and default date_format are required) |
header_to_task | false | If true, a project title line will be converted to a task on the certain keystroke |
decimal_minutes | false | If true, minutes in lasted/wasted tags will be percent of hour, e.g. 1.50 instead of 1:30 |
tasks_bullet_space | whitespace or tab | String to place after bullet, might be any character(s) |
highlight_past_due | true | If true, highlight past, soon, and invalid @due(something) |
highlight_due_soon | 24 | Hours as int, threshold to define which @due will be soon |
scope_past_due | string.other.tag.todo.critical | Any scope, define color for past @due |
scope_due_soon | string.other.tag.todo.high | Any scope, define color for @due will be soon |
scope_misformatted | string.other.tag.todo.low | Any 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_due | false | In Sublime 3, show remain or overdue time under due tags |
show_calendar_on_tags | false | In 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_offset | 0 | Place 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.
Directive | Description |
---|---|
$o | Amount of pending tasks |
$d | Amount of completed tasks |
$c | Amount of cancelled tasks |
$n | Sum of completed and cancelled tasks |
$a | Sum of all tasks |
$percent | Ratio of $n to $a |
$progress | Percent as pseudo graphics (absents if less than 10%) |
$last | Date 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