AlfreDo

An Alfred Workflow for Todoist.

NOTE: app not created by, affiliated with, or supported by Doist.

• Motivation
• Setting up
• Basic Usage
• Known Issues
• Acknowledgments
• Changelog
• Feedback

Motivation ✅

• Quickly list, search, and act on your Todoist tasks
• Add new tasks to Todoist through Alfred

Setting up ⚙️

Needed

• Alfred 5 with Powerpack license
• A Todoist account
• Python3 (howto here)
• Download AlfreDo latest release

Default settings

• In Alfred, open the 'Configure Workflow' menu in AlfreDo preferences
  • set the Todoist API token (login into your account, then generate it here)
• Optional:
  • set the keyword (or hotkey) to show:
    1. Tasks due today (default: !1)
    2. Overdue (default: !2)
    3. All tasks (default: !3)
    4. New task (default: !!!)
  • set the keyword (or hotkey) to force-refresh (default: todoist::refresh)
  • set the keyword (or hotkey) to create a new task (default: !!!)
  • set refresh rate (in days). Default: 1
    • Recommended 0 (refresh every time) or 1 if you use Todoist often from browser, mobile etc.
    • Database is automatically refreshed when a task is created, completed, or rescheduled.
    • Refresh can be forced using a keyword (default: todoist::refresh) or hotkey.
  • show Karma daily and weekly goals? Default: yes
  • partial match search? Default: yes. Search projects and labels anywhere in the string. Will search from start if unchecked
  • open task in Todoist app, or website

Basic Usage 📖

Searching your tasks 🔍

• launch with keyword or custom hotkey. You can start from 1) tasks due today, 2) tasks overdue, or 3) all tasks
• Use multiple strings, or label/projects to refine search. Use @ to enter one or more labels, # to enter a project/section.
• Once a task is selected, you can do one of three things:
  • enter ↩️ will open the task on Todoist (default) or in the Todoist app, based on user preference set in Configure Workflow
  • shift-enter ⇧↩️ will complete the task
  • ctrl-enter ^↩️ will open a menu to reschedule the task. Choose one of the options, or enter a date in international format, with (YYYY-MM-DDTHH:MM) of without (YYYY-MM-DD) time, or enter a number of days. You can also use w or m after the number to enter weeks and months, respectively (e.g. 10w will reschedule in 10 weeks)
  • Time (in 24h format) can be added after these shortcuts as well (e.g. 7w13:13).

Creating new tasks ⭐

• launch with keyword (default: !!!) or hotkey. Use @ to enter one or more labels (new ones can be created here), # to enter a project/section (Inbox will be used if none entered), due: to enter a due date, p[1-4] to enter a priority. As in reschedule, choose one of the options, or enter a date in international format, with (YYYY-MM-DDTHH:MM) of without (YYYY-MM-DD) time, or enter a number of days. You can also use w or m after the number to enter weeks and months, respectively (e.g. 10w will set a due date in 10 weeks). Time (in 24h format) can be added after these shortcuts as well (e.g. 7w13:13).
• Universal Action: new tasks can be created by selecting text in any app, then launching Universal Actions and selecting Create a new Todoist task.

Database refresh 🔄

• will occur according to the rate in days set in AlfreDo preferences, after a task is created, completed, or rescheduled, or...
  • todoist::refresh to force database refresh

Limitations & known issues ⚠️

• None for now, but I have not done extensive testing, let me know if you see anything!

Acknowledgments 😀

• Thanks to the Alfred forum community!
• Icons from Flaticon:
  • https://www.flaticon.com/free-icon/overdue_6534474
  • https://www.flaticon.com/free-icon/calendar_6816638
  • https://www.flaticon.com/free-icon/project-management_4844342
  • https://www.flaticon.com/free-icon/task_2098402
  • https://www.flaticon.com/free-icon/check_10308323
  • https://www.flaticon.com/free-icon/bowler-hat_3345848
  • https://www.flaticon.com/free-icon/new_3634451
• Thanks to Werner Dijkerman for help with troubleshooting.

Changelog 🧰

• 02-13-2024: version 0.4 new features and bug fixes (listed here)
• 11-10-2023: version 0.3 support for app, bug fixes
• 06-10-2023: version 0.2.2 support for sections, international date, time, supporting spaces in project names
• 05-03-2023: version 0.1

Feedback 🧐

Feedback welcome! If you notice a bug, or have ideas for new features, please feel free to get in touch either here, or on the Alfred forum.