HeapCL and TorchCL Now Available Through MacPorts

Friday, August 31st, 2012

I have some great news for Heap CRM or Torch Project Management users that also use MacPorts to maintain their command line tools: HeapCL and TorchCL can now be installed by MacPorts.

Instructions:

1) Makes sure you have the latest version of the ports tree. In the terminal type:

sudo port -v selfupdate

2a) Install HeapCL. In the terminal type:

sudo port install heapcl

2b) Install TorchCL. In the terminal type:

sudo port install torchcl

And that's it!

Get Messages from the Torch Project Management WebHook (and TorchCL)

Friday, January 6th, 2012

You can now retrieve messages using the Torch Project Management webhook. If I set the variable (JSON, POST or GET) “list” to “messages John Doe” I will get a JSON payload containing messages associated to the prospect John Doe.

Sense TorchCL is just a client to the WebHook, you can now retrieve this information directly from the terminal. If I type:

./torchCL --list "messages WebSite Design" --save "messages.csv"

I'll get a CSV containing messages in the project WebSite Design. If I type:

./torchCL --list "messages WebSite Design" --save "messages.txt"

I'll get a plain text file containing each message.

TorchCL has been updated, so all users should download the latest version.

TorchCL >

GTD to CSV

Friday, May 13th, 2011

GTD to CSV is a simple free program that converts GTD style event/task text files to a CSV format that Heap CRM and Torch Project Management can import as events and tasks.

This completes the circle: you can export events/tasks from HeapCL and TorchCL and save them in GTD format, convert them to CSV and import CSVs to Heap and/or Torch.

Import Events/Tasks into Torch Project Management via CSV

Thursday, May 12th, 2011

Torch Project Management now supports importing of events via CSV (import under the calendar tab):

CSV Header

To keep it simple, there is only one required field: title. Just like in the app, the start and end time is parsed directly from the title field (if they exist at all). If the item doesn't have a date, it is considered a task. However, all fields are supported, including pinned.

The import format matches the event CSV export added to TorchCL in March.

Example CSV >

Using Torch Project Management from Alfred

Sunday, May 8th, 2011

Do you use Alfred and Torch Project Management? Now, just like LaunchBar or QuickSilver, you can interact with Torch directly from within Alfred.

In the new version of Alfred (version .9) you can setup terminal / shell shortcuts that automatically send data to TorchCL. Here is an image of my current shortcuts:

So if I wanted to mark a task as complete (in this case "TPS Report"), I would type:

Creating one of these shortcuts is super easy. For instance this is shortcut for completing a event/task:

Other Shortcuts:

Keyword: done:
Command: source ~/.bash_profile;torchCL --title "Simulated Message" --body "[complete: {query}]" --simulate

Keyword: expense:
Command: source ~/.bash_profile;torchCL --title "Simulated Message" --body "[expense: {query}]" --simulate

Keyword: expenses
Command: source ~/.bash_profile;torchCL --list "expenses" --save "~/desktop/results.csv"

Keyword: expenses:
Command: source ~/.bash_profile;torchCL --list "expenses {query}" --save "~/desktop/results.csv"

Keyword: invoices
Command: source ~/.bash_profile;torchCL --list "invoices" --save "~/desktop/results.csv"

Keyword: invoices:
Command: source ~/.bash_profile;torchCL --list "invoices {query}" --save "~/desktop/results.csv"

Keyword: payments
Command: source ~/.bash_profile;torchCL --list "payments" --save "~/desktop/results.csv"

Keyword: payments:
Command: source ~/.bash_profile;torchCL --list "payments {query}" --save "~/desktop/results.csv"

Keyword: task:
Command: source ~/.bash_profile;torchCL --title "Simulated Message" --body "[event: {query}]" --simulate

Keyword: tasks
Command: source ~/.bash_profile;torchCL --list "events" --save "~/desktop/results.csv"

Keyword: tasks:
Command: source ~/.bash_profile;torchCL --list "events {query}" --save "~/desktop/results.csv"

Keyword: time:
Command: source ~/.bash_profile;torchCL --title "Simulated Message" --body "[time: {query}]" --simulate

Keyword: times
Command: source ~/.bash_profile;torchCL --list "time" --save "~/desktop/results.csv"

Keyword: times:
Command: source ~/.bash_profile;torchCL --list "time {query}" --save "~/desktop/results.csv"

Alternatively you can simply download this zip file and move the contents to your Alfred scripts folder (~/Library/Application Support/Alfred/extensions or in your dropbox if you are syncing).

Alfred shortcuts >

Updates to TorchCL / List Events, Filter by Project & Save in GTD Format

Sunday, March 20th, 2011

To support the new features in the WebHook, TorchCL (Torch Project Management's command line interface) has been updated.

Listing Events

First, let's say I want to list events, I can type:

./torchCL --list="events"

And that would return all uncompleted, pinned events to my screen. I also could type:

./torchCL --list="events" --save="events.csv"

Which would save those events to a CSV file (in this case named events.csv).

Filtering Lists

Just like the WebHook itself, TorchCL now supports filtering lists when using the "all active projects" WebHook url. Let's say I want any invoice in the project WebSite Design, I could type:

./torchCL --list="invoices WebSite Design" --save="invoices.csv"

And have the results saved to the file "invoices.csv". I can also filter events; let's say I want any event in the project "Newsletter". I could type:

./torchCL --list="events Newsletter"

Which would return uncompleted and pinned events in the newsletter project to my screen. Filters can be applied to events, invoices, payments, time and expenses.

Saving in GTD Format

When listing events, you now have the option to save in a GTD (Getting Things Done) style format. If I type something like (ie. the key difference being the ".txt" instead of ".csv"):

./torchCL --list="events" --save="events.txt"

TorchCL will save a file similar to the following:

+WebSite_Design Review Graphics
+WebSite_Design @Graphics Lunch with John at 12:00 PM to 01:00 PM on Mar 26th, 2011

Where each event is on its own line, projects are specified with a "+" and categories are specified with the "@" sign. This format is commonly used when applying David Allen's Getting Things Done methodology and is compatible with programs like Todo.txt.

Updates to LaunchBar and QuickSilver Scripts

Both the LaunchBar and QuickSilver action scripts have been updated to take full advantage of the additional features. So once you update your action scripts, you can filter lists, grab events and save events in GTD format.

LaunchBar Action Script >
QuickSilver Action Script >

Installation and Update

Because of substantial changes to TorchCL, it is recommend for all users to download a new copy. Those of you updating will not have to reconfigure any settings, you will simply have to overwrite your existing installation with the new one.

Download >
More about TorchCL >

Convert TorchCL exports to Ledger Format

Saturday, March 5th, 2011

If you happen to be using both Torch Project Management and Ledger you can now easily convert invoice, payment and expense entries into a format appropriate for Ledger.

For instance, the following would convert a payment CSV into a set of appropriate transactions.

./csvToLedger --open="payments.csv" -a "Assets:Checking, Assets:Accounts Receivables" -f "amount" -d "timestamp" -n "projectname" -s "save.txt"

For more info, and to download the software, go to:

https://github.com/tazzben/csvToLedger/wiki

Payments via JSON WebHook and API (Torch Project Management)

Thursday, March 3rd, 2011

You can now retrieve payment entries from Torch Project Management's WebHook or API. Just set the variable "list" to "payments" (there is an example under your help section). This will result in something like:

[{
"key": "13",
"timestamp": "2010-07-16 00:00:00",
"amount": "2050.000000",
"note": "Payment by Check",
"invoicename": "WebDesign Services",
}]

from the WebHook. Or something like this:

<?xml version="1.0" encoding="ISO-8859-1"?>
<response>
<list>
<payment>
<key>13</key>
<timestamp>2010-07-16 00:00:00</timestamp>
<amount>2050.000000</price>
<note>Payment by Check</note>
<invoicename>WebDesign Services</invoicename>
</payment>
</list>
</response>

from the API.

Because this is an update to the WebHook, this also means it will work with TorchCL. So, if you've ever wanted to automated entries into your ledger or more quickly create cash-flow statements, now it is just a command away.

Note:

The QuickSilver and LaunchBar integration scripts have been updated to recognize "payments" as an action. If you use either of these scripts, you should download the new version.

Using Torch Project Management from QuickSilver

Tuesday, February 1st, 2011

Do you use both QuickSilver and Torch Project Management? Check this out:

Let’s say you want to create an event; just invoke QuickSilver and type “.” (to get to the variable input field) and type an event command (like “event: Finish Graphics”):

Tab to the second panel and select “Torch”. The task is now created in Torch Project Management.

What else can you type?

complete: Event/Task Name
Marks the event or task “Event/Task Name” complete.

time: Note about time:1.5
Creates a time entry for 1.5 hours with a note of "Note about time".

expense: Note about expense:200
Creates an expense entry for $200 with a note of "Note about expense".

time
Retrieves all relevant time entries and saves the result to your desktop as a CSV.

expenses
Retrieves all relevant expenses and saves the result to your desktop as a CSV.

invoices
Retrieves all relevant invoices and saves the result to your desktop as a CSV.

Edit: Added March 4th: payments
Retrieves all relevant payments and saves the result to your desktop as a CSV.

Edit: Added March 20th: events
Retrieves all relevant uncompleted and pinned events and saves the result to your desktop as a CSV and TXT.

You can also filter any of the above commands by typing the name of the project you wish to examine. For instance you might type "events Newsletter Graphics" to get just the events in the "Newsletter Graphics" project.

How to Install:

Download this AppleScript and move it into the “Actions” folder within your QuickSilver install (~/Library/Application Support/Quicksilver/Actions). Prior to installing this script you must have TorchCL installed with your path variable set.

Video:

MP4 >
WEBM >
Theora >

Download:

Download Script >
TorchCL >

Using Torch Project Management from LaunchBar

Tuesday, February 1st, 2011

Do you use both LaunchBar and Torch Project Management? Check this out:

Let’s say you want to create an event; just invoke LaunchBar and type “torch” and the following event command:

The task is now created in Torch Project Management.

What else can you type?

complete: Event/Task Name
Marks the event or task “Event/Task Name” complete.

time: Note about time:1.5
Creates a time entry for 1.5 hours with a note of "Note about time".

expense: Note about expense:200
Creates an expense entry for $200 with a note of "Note about expense".

time
Retrieves all relevant time entries and saves the result to your desktop as a CSV.

expenses
Retrieves all relevant expenses and saves the result to your desktop as a CSV.

invoices
Retrieves all relevant invoices and saves the result to your desktop as a CSV.

Edit: Added March 4th: payments
Retrieves all relevant payments and saves the result to your desktop as a CSV.

Edit: Added March 20th: events
Retrieves all relevant uncompleted and pinned events and saves the result to your desktop as a CSV and TXT.

You can also filter any of the above commands by typing the name of the project you wish to examine. For instance you might type "events Newsletter Graphics" to get just the events in the "Newsletter Graphics" project.

How to Install:

Download this AppleScript and move it into the “Actions” folder within your LaunchBar install (~/Library/Application Support/LaunchBar/Actions). Prior to installing this script you must have TorchCL installed with your path variable set.

Video:

MP4 >
WEBM >
Theora >

Download:

Download Script >
TorchCL >