AlfreDo
AlfreDo copied to clipboard
Alfred for Todoist
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:
- Tasks due today (default:
!1
) - Overdue (default:
!2
) - All tasks (default:
!3
) - New task (default:
!!!
)
- Tasks due today (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) or1
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.
- Recommended
- 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
- set the keyword (or hotkey) to show:
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 inConfigure 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 usew
orm
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 usew
orm
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.