giovannicoppola/beeAlfred

An Alfred workflow to manage and update Beeminder goals

beeAlfred

Mind the 🐝 with Alfred!

A workflow to manage and update your Beeminder goals with Alfred.

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

Setting up beeAlfred ⚙️

1. Download beeAlfred from Github and double-click to install

2. Get your Beeminder Auth Token

   • in Beeminder, Account Settings > Apps & API > Copy the Auth Token (for the Beeminder API)

3. Set the BEETOKEN variable

   • In Alfred, open the 'Configure Workflow' window in beeAlfred preferences
     • set the BEETOKEN variable to the Beeminder Auth Token retrieved in Step 2
     • set the BEEUSER value to your Beeminder username

4. Optional: Setup a hotkey to launch beeAlfred

5. Optional: Change the keyword to launch beeAlfred

   • keyword currently set to !q

6. Optional: Change the comment string (currently: -- from Alfred 🐝)

   • In Alfred, open the 'Configure Workflow and Variables' window in beeAlfred preferences
   • Edit the BEECOMMENT variable

Basic Usage 📖

Checking the status of your goals

• launch beeAlfred by typing !q or using an optional hotkey
• beeAlfred will return goals and their status/deadline

Entering a new datapoint

• search a goal by typing !q followed by a goal name or matching string
• select your goal by pressing return.
  • option-return (⌥⏎) will open the goal in Beeminder
• enter your value plus an optional comment after space

Limitations & Known issues ⚠️

• beeAlfred is using the local timezone to compute derail time. It might not correspond to the real derail time if a different timezone is set on beeminder.com
• nothing else for now, but I have only tested a few use cases, let me know if you see anything!

Acknowledgments 😀

• Dean Jackson and Vitor Galvāo for their incredible help on the Alfred mailing list and for creating many scripts used as templates for this workflow.

Changelog 🧰

• 07-06-2023: version 2.2 (fixed typo in variable name)
• 12-05-2022: version 2.1 (Alfred 5)
• 03-15-2022: version 2.0 (Python3, no dependencies)
• 05-23-2021: version 1.0.2 (adding pledge)
• 05-18-2021: version 1.0.1 (minor fixes)
• 05-17-2021: version 1.0

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 Beeminder/Alfred forums.