Skip to content

Latest commit

 

History

History
120 lines (83 loc) · 5.63 KB

README.md

File metadata and controls

120 lines (83 loc) · 5.63 KB

AlfreDo

An Alfred Workflow for Todoist.

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

Downloads

Motivation ✅

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

Setting up ⚙️

Needed

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 😀

Changelog 🧰

  • 05-20-2024: version 0.4.1 bug fix
  • 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.