Add link to Org Babel section from Worg main page
[Worg.git] / org-contrib / org-mac-link-grabber.org
blobc0e143bc0feb7275eb16f079ed70adafb6b74034
1 #+TITLE:     org-mac-link-grabber.el -- Grab links from open Mac applications
2 #+OPTIONS:   ^:{} author:nil
3 #+STARTUP: odd
5 [[file:index.org][{Back to Worg's contibutions index}]]
7 * Overview 
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.
13 *** Supported Applications
15         The following applications are currently supported:
16         - Finder.app
17         - Mail.app
18         - Address Book.app
19         - Safari.app
20         - Firefox.app
21         - Firefox.app with the Vimperator plugin
22         - Google Chrome.app
23         - Together.app
25 * Installation
26   
27   Customize the org group by typing =M-x customize-group RET org RET=, then
28   expand the /Modules/ section, and enable =mac-link-grabber=.
30   You may also optionally bind a key to activate the link grabber menu, like
31   this:
33   : (add-hook 'org-mode-hook (lambda () 
34   :   (define-key org-mode-map (kbd "C-c g") 'omlg-grab-link)))
36 * Usage 
38   Activate the grabber by typing *C-c g* (or whatever key you decided
39   to bind, as above), or type *M-x omlg-grab-link RET*. This will give
40   you a menu in the modeline allowing you to select an application.
41   The current selection in that application will be inserted at point
42   as a hyperlink in your org-mode document.
44 * Customizing
46   You may customize which applications appear in the grab menu by
47   customizing the group /org-mac-link-grabber/. Changes take effect
48   immediately.