3f5861622b3eccc9e3c25ae242ed4365fad2d948
[worg.git] / org-contrib / org-mac-link-grabber.org
1 #+TITLE:     org-mac-link-grabber.el -- Grab links from open Mac applications
2 #+OPTIONS:   ^:{} author:nil
3 #+STARTUP: odd
4
5 [[file:index.org][{Back to Worg's contibutions index}]]
6
7 * Overview 
8
9   This code will allow you to grab the current link or selection from
10   an open mac application and insert it as a hyperlink at point in an
11   org-mode document.
12
13 *** Supported Applications
14
15         The following applications are currently supported:
16         - Finder.app
17         - Mail.app
18         - Address Book.app
19         - Safari.app
20         - Skim.app [fn:: Supported in the latest version from Git]
21         - Firefox.app
22         - Firefox.app with the Vimperator plugin
23         - Google Chrome.app
24         - Together.app
25           
26 * Installation
27   
28   Customize the org group by typing =M-x customize-group RET org RET=, then
29   expand the /Modules/ section, and enable =mac-link-grabber=.
30
31   You may also optionally bind a key to activate the link grabber menu, like
32   this:
33
34   : (add-hook 'org-mode-hook (lambda () 
35   :   (define-key org-mode-map (kbd "C-c g") 'omlg-grab-link)))
36
37 * Usage 
38
39   Activate the grabber by typing =C-c g= (or whatever key you decided
40   to bind, as above), or type =M-x omlg-grab-link RET=. This will give
41   you a menu in the modeline allowing you to select an application.
42   The current selection in that application will be inserted at point
43   as a hyperlink in your org-mode document.
44
45 * Customizing
46
47   You may customize which applications appear in the grab menu by
48   customizing the group /org-mac-link-grabber/. Changes take effect
49   immediately. If you are using the latest org-mode from Git, you can
50   also customize whether the =org-mac-link-grabber= should highlight
51   the selected text when grabbing the link from Skim.app.