43 Folders

43 Folders feed subscription icon - Shiny! Drowning in email? Try Inbox Zero to learn sane tips for dealing with high-volume email. And don’t miss the free Inbox Zero video. »

Login or register

Register for free on 43 Folders to comment on articles, post to our forum, customize your visits, and much more. Current users can login now.

Quicksilver's Append: An updated appreciation + Robert's troubleshooter

Append to 2: Electric Boogaloo

The Quicksilver feature that will most dramatically change how you work is probably “Append to…” (or, when you prefer, “Prepend to…”). We first covered this back in the Bronze Age of 43F, and it’s come up again repeatedly here, in the podcast, and elsewhere. And with good reason, I think. It’s jaw-droppingly useful, and is the single best way I know of to ensure that “ubiquitous capture” can always occur without causing disruption or unnecessary modal change.

To review, for you new kids, Quicksilver, when properly configured (more on that in a minute), will let you add a line of text to any text file on your Mac. As long as it’s included in a QS catalog someplace, you’re a few fast keystrokes away from capturing your brilliant but ephemeral idea without stopping what you’re doing. This is huge, in practice, believe me.

A few uses we have loved?

  • Got some great cookies at work today? Add “milk” to your “groceries.txt” file
  • Found a broken link in a disused site of yours? Append it to “urls to fix.txt”
  • Just had a great idea for Mom’s Christmas gift? Add it to “mom xmas ideas.txt”
  • Found a great quotation you don’t want to forget? Drop it in “quotes.txt”
  • Just suddenly remembered the name of the girl you had a crush on in kindergarten? That goes in “people to google.txt”
  • Finally thought of a great response to a flame you got? Acidly add it in “l’esprit descalier.txt”

As I said to the Tinderbox group on Saturday — this approach is the most efficient way I know of to get it all down whenever you’re at your Mac:

  • create receptacles for information you want to collect (“name of thing you’re collecting.txt”)
  • get fast at learning how to Append via Quicksilver
    • It should be pure muscle memory
    • Consider adding QS keyboard triggers for appending to your five most used lists
  • review your collections periodically as needed (daily for “groceries,” annually for “good names for notional Marx Brothers”)
  • continue through life never worried you’re missing something good

This is all partly in the service of bubbling up (and lovingly rehashing) something I adore, but it’s also to share some very useful advice from the de facto Vice President of 43 Folders, Mr. Robert Daeley. As Robert notes, there are several problems that can cause QS to barf on your append functionality. Tracking down the exact cause has sometimes driven friends of 43F to the brink — so much did they crave the Power of Append.

Well, friends, Robert has come to the rescue with this handy guide to finding what the hell is wrong with your setup. Many thanks to him.


Appendicitis: Troubleshooting the Quicksilver Append Hack

by Robert Daeley

A little over a year ago, Merlin posted what turned into one of the most popular of his hints: Quicksilver: Append to a text file from anywhere. This is a very cool example of the power of Quicksilver’s dual CLI/GUI nature.

Unfortunately, being on the bleeding edge of technology at the time, there were quite a few issues with what was beta functionality. And while things have gotten much better now that more development has passed, the steps necessary to make the hint work are still rather convoluted to the uninitiated.

This article codifies all of the various caveats and prerequisites for you to enjoy appending (and prepending) to text files. I researched using b45 Saint Bernard (3348). You can find what version of Quicksilver you’re running by choosing ‘About Quicksilver’ from its menu item or the small triangle in the upper righthand corner of the Quicksilver window.

The following assumes that you have Quicksilver installed and running (get it from here), and that you’re at least passing familiar with its Preferences window. The plug-in in question is now in Stable features, last updated on May 2, 2005.

Quicksilver requirements

  • You’ll need to be using at least b29 which is when the plug-in went beta, but the more recent the better.

Quicksilver preferences

  • In the Application pane, turn on ‘Enable advanced features’ — ‘Stable’ is okay in the adjacent popup menu.
  • In the Plug-ins pane, ‘Text Manipulation Actions (+)’ must be installed and turned on. If you don’t see it in the initial list, you can find it under ‘More Plug-ins’ (choose from popup menu).

Text file targets

  • Must be a plain text file.
  • Must be a member of a QS Catalog you’ve added and indexed to the proper depth.
  • Must have .txt extension.
  • Dotfiles (e.g., ‘.reminders’ or ‘.vimrc’) cannot be selected.

Inevitably, another caveat will arise after publishing this article ;) so please let us know via the comments.


Found a new bug or hangup? Read the troubleshooter and double-check all your settings. If it’s still driving you crazy, chime in with a comment, and we’ll try to help you out (with us adding to Robert’s list of caveats as needed).


Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
Trachalio's picture

I ♥ appent to a...

I ♥ appent to a text file. I’ve got a few in the notes folder in my iPod that are in the quicksilver catalogue (with a .txt extension so the iPod can read them) and just keep dumping everything I think of into them. And because they’ve got the .txt extension the iPod can read them as regular notes files… no paper wasted!

grant's picture

My problem is that Quicksilver...

My problem is that Quicksilver appends a newline and then the text. Most of my text files end with a newline, so QS messes them up. Ideally it would check if the last character of the file is a newline and, in that case, append the text and then a newline.

Alderete's picture

I am still living in...

I am still living in OS X 10.3.9, which means living with QS b36 (1C39). Even with Enable advanced features checked, and set to Beta, I am not finding the Text Manipulation Actions plugin on the Download More Plug-Ins web page. Is there an extra trick to finding/using this plug-in if you’re on the older version of QS?

Matt Henderson's picture

As an alternative, if you...

As an alternative, if you use DEVONthink, is to enable the “Services Menu” support in QuickSilver, then do this:

  1. Invoke QuickSilver
  2. Type your text or whatever
  3. DEVONthink / Take Plain Note
Jack Mottram's picture

It might also be worth...

It might also be worth pointing out/reminding folk that you can bring up a file in Quicksilver, then select Append/Prepend Text, then tab to the next pane and enter your text (i.e. the other way around to the method detailed in the original hint).

A tiny and/or obvious point, maybe, but I only noticed Quicksilver could work this way recently, and have found it very useful, especially if I’ve just used the Create File action: the new file created appears when you next invoke QS, and I had been hitting ‘.’ to enter text, selecting Pre/Append Text and navigating to my new file, when I could’ve been adding to it immediately (I hope this is useful to someone and not just more evidence that I don’t tinker with QS as much as I should!)

Andy Fast's picture

Aha! Exactly, the post I've...

Aha! Exactly, the post I’ve been waiting for. I had been trying out Quicksilver (b45) for about a week and couldn’t find the Text manipulation plug-in anywhere. After reading this post, I reinstalled everything, still no luck. Turns out I needed to ‘Get more plug-ins’ (select Quicksilver -> Get More Plug-ins… or cmd+~) from the Application menu. Suddenly I had a huge list of available plugins, including Text manipulation. Finally, I can append to my todo lists from QS!

Alcor's picture

"Ideally it would check if...

“Ideally it would check if the last character of the file is a newline and, in that case, append the text and then a newline.”

Okey dokey.

James's picture

Y'all are killing me. I...

Y’all are killing me. I keep trying to Invoike QS while at work (on my Windows machine!)

Now that I have it working I’m fiending for it at work….

Ctrl + Alt + Everyone buy Apple + Enter

Merlin Mann's picture

Alcor said: Okey dokey. Now that’s...

Alcor said: Okey dokey.

Now that’s what I call service.

Nathan's picture

One small caveat that I...

One small caveat that I have experienced is that the file to which you are appending must have been created by an application that “marks” the file as text. That is, if you were a unix geek in a previous life (like myself) and you’re still creating .txt files in vim and xemacs, Quicksilver’s append will not work for you. You need to be creating files in a Mac-aware text editor for this to work properly. (At least, it hasn’t worked for me—OS X 10.3.9 and whatever QS last runs on that.)

grant's picture

Merlin: Now that’s what I...

Merlin: Now that’s what I call service.

For sure. I guess I should have filed a bug report back in the bronze age instead of just forgetting about it for a year.

Thanks, Alcor.

Architel News, Alerts & Tips Blog :: Turn Architel On an's picture

[...] QuickSilver is an adaptive...

[…] QuickSilver is an adaptive search application that can help getting things done by learning what you like to do. It can Launch programs and then learn which ones you open the most and give those to you first. The cool thing is that any type of object that you "Drag" into it can perform a series of "actions" and then learn from them. A great application of this adaptive searching can be found over at 43Folders where you can take any text you find or are typing and have it add that to a categorized TXT file. […]

Robert Daeley's picture

Nathan -- I haven't noticed...

Nathan — I haven’t noticed that to be true on my setup, currently 10.4.3, if that makes any difference. Which isn’t to say this isn’t an additional item for the list, with the extra rider that it may only apply to pre-Tiger systems. What I’d like to hear is if there are any other folks experiencing this particular issue and what their setup is.

Anja's picture

I might just be stupid,...

I might just be stupid, but like Alderete I can’t find the plug-in. Exact same problem. Please help the uninitiated. I’m geeky enough to want to be able to do this, but nok geeky enough to figure out how…

Anja's picture

Well the problem solved itself...

Well the problem solved itself half-way, because the append command is there without the plugin (OS 10.3.9 and QS b36). However, nothing happens to the text file, so now it appears I have the same problem as Nathan? I used Textedit to create the file, and it has the right suffix (.txt).

Amy's picture

Anja, my experience with b36...

Anja, my experience with b36 is that you can’t append to a file that’s currently open — are you creating a file and then trying to append to it right away? Note that your editor can be open, just not the file itself. I’m not sure if the same applies to the Tiger version, but it is consistent under Panther with several different editors.

Nathan, I’m not sure you’re right about Mac-aware editors. I’ve been creating files with touch and appending to them successfully, and I can’t think of a more plain-vanilla way to create a file than that. (In fact, since I haven’t been able to hunt down the elusive Create File QS functionality, my unseemly love for touch has been renewed.)

stuff » Blog Archive » Quicksilver%u2019s Append's picture

[...] Quicksilver%u2019s Append: An updated...

[…] Quicksilver%u2019s Append: An updated appreciation Robert%u2019s troubleshooter | 43 Folders […]

Steve's picture

My TextEdit seems to add...

My TextEdit seems to add a .rtf extension instead of a .txt. The append feature doesn’t seem to work with an .rtf file. Does anyone know how to convert to an .rtf? It doesn’t seem to be an option under “save as”

Thanks, Steve

Robert Daeley's picture

Steve -- .rtf is TextEdit's...

Steve — .rtf is TextEdit’s default format, but it can produce .txt plain-text files as well. You can convert a given .rtf file by going to Format menu and choosing ‘Make Plain Text’. This will convert the file and change it to an Untitled document that will need saving.

If you want to have TextEdit default to plain text format, you can switch it under Preferences.

Berko's picture

Steve, you have two options....

Steve, you have two options. You can create plain text on a file by file basis using Format> Make Plain Text or you can set TextEdit to always create new files in plain text in Preferences> New Document> Format. This drove me crazy when I was still using TextEdit for my web designs. Thankfully, I discovered SubEthaEdit and TextWrangler.

Berko's picture

Damn, Robert beat me to...

Damn, Robert beat me to it.

Angus's picture

Okay, I'm on B36 and...

Okay, I’m on B36 and CANNOT find a text plugin at the Blacktree page. And after trying several times, with a .txt file, I cannot append, though sometimes Quicksilver teases me by coming up with the word append.

What am I doing wrong? argggg

Nathan's picture

Amy -- hmmm, interesting! ...

Amy — hmmm, interesting! I’ve tried using touch also, but it doesn’t work for me. I wonder what the difference between your setup and my setup is? OS X 10.3.9, QS beta36…my list of plugins and versions folllows:

  • Apple Address Book, v82
  • Bezel Interface, v82
  • Camino, v0.5.0
  • Clipboard, v90
  • Dict Action, v1.1.4
  • Extra Scripts, v82
  • Finder, v0.5.0
  • HotKey Triggers, v81
  • iTunes, v176
  • Primer, v183
  • Safari, vE9
  • Web Search, v65

The only other weird thing I might have done to my QS install is to change the hotkey; Ctrl-Option-Space triggers QS for me (the default interferes with Emacs).

Anja's picture

Amy, I closed it -...

Amy, I closed it - so (unfortunately) that’s not the problem. I’ll try again with different files, maybe it just needs some time to adjust (who knows?). But thanks anyway!

Astronaut's picture

Okay, so I'm a relative...

Okay, so I’m a relative QS newbie, but here’s a question: Why do I get only the option to search when I invoke my text file and then invoke the append to or prepend to command? Any ideas?

Steve's picture

Thanks for the help converting...

Thanks for the help converting an rtf to a .txt. Can you append to an open text edit file? It only seems to work for me if the file is closed.

Iain K. MacLeod's picture

?45. No Text Manipulation Actions...

?45. No Text Manipulation Actions (+) listed under More Plug ins. :(

Daniel's picture

It works! It's great! Thank...

It works! It’s great! Thank you.

Michael's picture

I am not a Mac...

I am not a Mac person, and hence do not know the first thing about how Macs work, let alone how Quicksilver works. But the idea of easily appending to files struck me as useful…then I noticed the comment:

“…and you’re still creating .txt files in vim and xemacs, Quicksilver’s append will not work for you.”

I had actually been wondering if XEmacs’ ChangeLog mode (C-x 4 a/add-change-log-entry) could be modified to do something along the same lines…

A quick scan of the docs says:

add-change-log-entry &optional WHOAMI FILE-NAME OTHER-WINDOW NEW-ENTRY

So I guess you’d just need to make some sort of binding to add-change-log-entry that prompted for your filename. Or even add a menu that listed you most popular todo-list files.

The advantage/disadvantages:

Changelog adds a username and date stamp (plus or minus?), and, as far as I can tell it always prepends.

The New-entry field is, unfortunately, just a boolean that determines whether to add the next entry as a separate record (complete with its own date stamp) or to add it to the existing text under the current date record.

…but since (X)Emacs is highly versatile and programmable, I’m sure these things could be worked around with some clever scripting.

P.S. I would love to see some more Windows- or *nix-oriented stuff on 43F - I keep reading about tools that sound immensely useful, then find that they are Mac-specific :}

girtby.net » Blog Archive » MacOS X Essentials's picture

[...] Don’t forget to look...

[…] Don’t forget to look at 43folders for lots of Quicksilver tips. […]

 
EXPLORE 43Folders THE GOOD STUFF

An Oblique Strategy:
Discard an axiom


STAY IN THE LOOP:

Subscribe with Google Reader

Subscribe on Netvibes

Add to Technorati Favorites

Subscribe on Pageflakes

Add RSS feed

The Podcast Feed

Inbox Zero

The original 43 Folders series looking at the skills, tools, and attitude needed to empty your email inbox — and then keep it that way. Don’t miss the free video of Merlin’s Inbox Zero presentation.

Get Started with ‘GTD’

David Allen’s popular productivity book and the system on which it’s based help turn ‘stuff’ into actions that support valuable outcomes.