TickTick Alfred Workflow

This workflow allows you to search, open, add, and complete tasks in TickTick

View in Alfred Forums

Table of Contents

• Installation
• Setup
• Usage
  • Lists
    • List Search
    • Create List
  • Tasks
    • Task Search
    • Complete Task
    • Create Task
  • Sync
  • Calendar
    • Calendar (Day)
    • Calendar (Week)
    • Calendar (Month)
• Current Limitations
• Contributing
• Acknowledgements
• License

Installation

Click here to download the latest version of the workflow. Or you can build it yourself by cloning this repo into your Alfred workflows directory. To run this workflow, you will need to have the Alfred Powerpack and python3 installed.

Libraries such as python3 and parsedatetime are included in the workflow, so you don't need to install them yourself.

Please note, this workflow is not an official TickTick product and is not affiliated with TickTick in any way.

Setup

1. Go to https://developer.ticktick.com/manage and create a new app with any name you want. You'll be asked for a redirect url, please enter in http://localhost.
2. Now you should have a "Client ID" and "Client Secret". Copy these values.
3. Here it also asks for "OAuth redirect URL", please enter http://localhost and save.
4. Go to "Configure Workflow" button on this workflow on Alfred, paste the "Client ID" and "Client Secret"
5. Using Alfred, type in tsetup1 and authorise the workflow, you'll be redirected to http://localhost?code=xxxxx. Please copy the code from the url.
6. Using Alred, type in tsetup2 followed by the code from the step 1 (e.g. tsetup2 xxxxx). You are now ready to use the workflow!

Usage

Lists

List Search tls <query>

Search for a list in TickTick. Pressing enter will open the list in TickTick.

Create List tln <list-name>

Create a new list in TickTick with the given name.

Tasks

Task Search tts <query>

Search for a task in TickTick. Pressing enter will open the task in TickTick.

You can search for tasks in a few different ways:

• tts - Search for all tasks
• tts <task-name> - Search for tasks with the given name
• tts <list-name> - Search for tasks in the given list
• tts @today or tts @tod - Search for tasks due today
• tts @tomorrow or tts @tom - Search for tasks due tomorrow
• tts @thisweek or tts @tw - Search for tasks due this week

As mentioned in the Current Limitations section, you cannot search for tasks in Inbox at the moment.

Complete Task

You can complete a task by pressing cmd + enter when selecting a task in the search results from the Task Search command.

Create Task ttn <task-name>, <due-date>

Create a new task in TickTick with the given name.

You can add an optional comma at the end and include a due date using natural language:

• ttn Do laundry
• ttn Do the laundry, tomorrow at 5pm
• ttn Do the laundry, next week
• ttn Do the laundry, monday

As mentioned in the Current Limitations section, you can only add tasks to the Inbox list at the moment.

Sync tsync

Sync your TickTick account with the workflow by clearing the cache and fetching your latest lists and tasks. This is done automatically when:

• You search for a list or task, and it's been more than 5 minutes since the last sync
• You create a new list or task
• You complete a task

Once you run this command, please wait a moment for the sync to complete before searching for a list or task. This can take a few seconds if you have a lot of lists.

Calendar

Calendar (Day) tcd

Open the calendar in TickTick, in the day view.

Calendar (Week) tcw

Open the calendar in TickTick, in the week view.

Calendar (Month) tcm

Open the calendar in TickTick, in the month view.

Current Limitations

• Task search can take a while to load if you have a lot of lists - this is a limitation of the TickTick API as it requires a separate request for each list. Although once loaded it should be cached.
• You cannot search for tasks in Inbox - this is a limitation of the TickTick API.
• You cannot add tasks to any list other than Inbox - this is a limitation of the TickTick API.

As the TickTick API is quite new, I'm hoping these limitations will be fixed in the future.

Contributing

If you have any issues or feature requests, please open an issue or a pull request.

Acknowledgements

• TickTick API - The TickTick API used to build this workflow.
• ualfred & Alfred Workflow - The python3 library fork and the Alfred workflow library used to build this workflow.
• parsedatetime - Used to parse natural language dates and times for creating tasks.

License

This project is licensed under the MIT License - see the LICENSE file for details