Two-way sync between task managers (e.g. Remember the Milk) and HabitRPG
Version 1 is done! Development from here out will be driven by my experience using the tool and maybe yours? File issues!
Original idea: Read the plan at: https://trello.com/card/remember-the-milk/50e5d3684fe3a7266b0036d6/21.
This is a quick-and-dirty tool (currently planned to be a command line-only tool) to get Remember the Milk tasks into HabitRPG and track updates to both each time it's run. It isn't intended to be feature-complete, useful for everyone, or robust. But it is intended to work.
FULL_SYNC=1in the environment variables to do a full synchronization.
So it's not a true two-way synchronization yet, but it does the job and lets your tasks live in HabitRPG. I recommend deleting them from Remember the Milk and doing a synchronization if you want to delete one. If you want to track one in RTM only, then just delete it from HabitRPG. It might get synchronized again when you change it or complete recurring tasks, etc. in Remember the Milk.
Clone the repo and run
chmod +x main.js, then
./main.js. That works at least.
If all else fails,
node main.js. Put environment variables in front. In development, you might do something like:
BETA_MODE=1 DEBUG_MODE=1 ./main.js` (that's what I usually do)
The first time you run, the app will help you get authenticated with both services. You need accounts on both, of course.
[auth-dev] is used if in
[auth-beta] is not supported because the beta server uses the same DB as the live one.
These generally override anything else the app would try to find out.
HRPG_USER_ID: Set the
x-api-userinstead of getting it from
.habitrpgrc— good for development
HRPG_API_TOKEN: Set the
x-api-keyinstead of getting it from
.habitrpgrc— good for development
DEBUG_MODE: Set to
1to show more verbose output. Also currently works with the
rtmnodemodules bundled in
node_modules, though I might take it out when I release them separately. - good for development
DEV_MODE: Set to
BETA_MODE: Set to
https://habitrpg.com. Note that
DEBUG_MODEis stronger than this.
DRY_RUN: Set to any truthy value. Don't do any mutative (is that a word?) API operations. Still performs read-only operations. Note that dry run mode still goes through the authentication sequence for Remember the Milk and writes your credentials to a file. It would be fairly useless if it didn't do this. It does not write the marker file for last sync, since this would actually change behavior on the next run.
FULL_SYNC: Set to
1to sync all Remember the Milk tasks instead of just those added within the last week. It goes without saying that this may take a while.
FORCE: Run non-interactively. Simply setting this (even
FORCE=) is enough. Try to avoid doing this. The prompts are in there for a good reason.
FROB: ...internal use only, implementation detail etc. etc.. Basically, if the app gives you an auth URL and you exit out of the app before it authenticates you, but you authorize it on the RTM side, you can copy the
frobfrom the query string and provide it on the command line. This will skip getting a new one from the API.
My next goal is to ignore recurring tasks. And maybe to complete tasks in Habit when they have been completed on the remote end.
I hope this kind of functionality makes it into HabitRPG itself. This is intended as a stopgap, but if people like it, maybe I'll work on it more. Maybe. Civilized requests will get infinitely more attention than entitled flaming.
Complaining about the license is fine. Since it's free, I figured it ought to stay that way even if worked on by others. Give me some compelling reasons, and I'll consider relicensing.
Remember the Milk wants me to tell you that: "This product uses the Remember The Milk API but is not endorsed or certified by Remember The Milk." So take heed.