URL Scheme

GoodTask supports 'URL Scheme' and x-callback-url protocol.

GoodTask's URL scheme is goodtask3://
You can use this scheme to simply open the app.


URL Format

goodtask3://[action]?[action parameters]
or
goodtask3://x-callback-url/[action]?[action parameters]


Open Add

goodtask3://openadd


Open Specific View

goodtask3://view?title=[prompt:Title]&view=[prompt:View]

or

goodtask3://view?section=[prompt:Section]&row=[prompt:Row]&view=[prompt:View]


title : Full title of list (case insensitive)
view (optional) : 1 (List), 2 (Day), 3 (Week), 4 (Month)

section (optional) : number of stack on list view - 1 ~
row : number of row on selected section - 1 ~
view (optional) : 1 (List), 2 (Day), 3 (Week), 4 (Month)


Smart Add

goodtask3://smartadd?text=[prompt:Text]

text : Text input. It'll automatically be parsed with Smart Add Rules (Text Snippets) you've made


Add

goodtask3://add?title=[prompt:Title]&list=[prompt:List Name]&due=[prompt:Due Date]&dueAfter=[prompt-num:Due after]&alarm=[prompt-num:Alarm]&priority=[prompt-num:Priority]&url=[prompt:URL]&notes=[prompt:Notes]

title : Title of the task
list (optional) : List name. Automatically matches shortened name. (ex. h for habits, t for this week). Default list is selected if not used.

due (optional) : Due date. Supports below format.
HH:mm - Sets on time today. If it has been passed, sets on tomorrow.
MM-dd - Sets on the date on default time.
yyyy-MM-dd - Sets on the date on default time.
MM-dd HH:mm
yyyy-MM-dd HH:mm

dueAfter (optional) : Minutes after current time. If 'due' is set, dueAfter is ignored.

alarm (optional) : 0(off), 1(on). Turns on alarm or not. Only works when 'due' or 'dueAfter' is set. It follows default if not set.

priority (optional) : 0, 1(!), 2(!!), 3(!!!)
URL (optional) : URL of the task
Notes (optional) : Notes of the task



Examples

Add task 'Title' on list 'To-do'
goodtask3://add?title=Title&list=to

Add task 'Title' due 10 minutes after
goodtask3://add?title=Title&dueAfter=10

Add task 'Title' due 6 pm
goodtask3://add?title=Title&due=18:00

Add task 'Title' due Feb 20th with alarm
goodtask3://add?title=Title&due=2-20&alarm=1

Add task 'Title' with priority !!
goodtask3://add?title=Title&priority=2

Adding task and come back to Launch Pro
goodtask3://x-callback-url/add?title=[prompt:Title]&list=[prompt:List Name]&due=[prompt:Due Date]&dueAfter=[prompt-num:Due after]&alarm=[prompt-num:Alarm]&priority=[prompt-num:Priority]&url=[prompt:URL]&notes=[prompt:Notes]&x-success={{launchpro:}}