public
Description:
Homepage:
Clone URL: git://github.com/jessegrosjean/quickcursor.git
name age message
file .gitignore Tue Aug 26 12:14:01 -0700 2008 first commit [jessegrosjean]
file .gitmodules Tue Sep 09 18:25:42 -0700 2008 pointed submodules to public repositories [jessegrosjean]
directory English.lproj/ Fri Sep 05 06:59:10 -0700 2008 version 0.2 [jessegrosjean]
file Info.plist Mon Nov 10 09:41:26 -0800 2008 updated build process [jessegrosjean]
file Plugin.xml Tue Aug 26 12:14:01 -0700 2008 first commit [jessegrosjean]
directory Plugins/ Fri Sep 05 07:10:36 -0700 2008 moved some files [jessegrosjean]
directory QuickCursor.xcodeproj/ Mon Nov 10 09:41:26 -0800 2008 updated build process [jessegrosjean]
file QuickCursor_Prefix.pch Tue Aug 26 12:14:01 -0700 2008 first commit [jessegrosjean]
file README.txt Fri Sep 05 07:18:27 -0700 2008 updated readme and version [jessegrosjean]
directory Vendor/ Mon Nov 10 09:29:38 -0800 2008 updated vendor [jessegrosjean]
file main.m Tue Aug 26 12:14:01 -0700 2008 first commit [jessegrosjean]
About:

QuickCursor is menu item that allows you to edit text from any application in your favorite text editor*. Unlike custom 
“edit in” plugin solutions QuickCursor provides a standard open source solution that uses public API's and doesn’t requir
e input manager hacks to work.

QuickCursor works by reading a string value from the source application via the current AXUIElement. Next it sets up a 
ODBEditor session with the preffered editor. When the preffered editor modifies the string QuickCursor writes that value 
back into the source application via the AXUIElement.

Todo:

- Figure out best way to setup keyboard shortcuts for items in the QuickCursor menu.
- Doesn't work with Mail.app. Mail.app's text area is a AXWebArea. It seems that the default kAXValueAttribute doesn't 
work for reading and writing AXWebArea's text. Need to find out how to read write text from AXWebArea and handle as a 
special case.
- String is written back into source application with [QCUIElement setValue:]. This generally works, but it seems to 
change the value behind the scenes... this can mess up undo stacks and such in the destination app. Needs to be some 
documenentation that describes how the source app can be made aware of these changes and how to custom handle them.
- Doesn't seem to work with BBEdit editor.

Building:

First checkout from github:

$ git clone git://github.com/jessegrosjean/quickcursor.git
...

Next init and update submodules:

$ cd quickcursor/
$ git submodule init
...
$ git submodule update
...
$ open QuickCursor.xcodeproj/ 

To build QuickCursor:

1. Open the QuickCursor XCode project ./QuickCursor/QuickCursor.xcode
2. In xCode preferences (XCode > Preferences...) go to the "Building" section and
make sure that you have a single customized location where all build products are
placed. See the "Place Build Products in:" label of that preference pane. I use "/xcodebuilds"
3. You should now be able to build the QuickCursor target.

Thanks,
Jesse Grosjean
jesse@hogbaysoftware.com