abo-abo / orca

ORg CApture

Introduction

Orca is an ORg CApture list of recipes; mainly for capturing from a browser.

The more this package is configured, the less refiling you’ll do on your captures: they will go directly to where they belong.

Here is my example list of configurations:

• Capture URL matching https://www.reddit.com/r/emacs to emacs.org:Reddit
• Capture URL matching https://emacs.stackexchange.com/ to emacs.org:Questions
• If the current buffer is e.g. foo.org and it has a * Tasks heading, capture to foo.org:Tasks
• If nothing else matches, capture to ent.org:Articles.

The package needs ripgrep to be able to detect already-captured links, but also works without.

Configuration

Just requiring the package, only the “capture to current buffer” method will work, since no file paths are recognized:

(require 'orca)

Customize the file paths to your liking using this template:

(setq orca-handler-list
      '((orca-handler-match-url
         "https://www.reddit.com/emacs/"
         "~/Dropbox/org/wiki/emacs.org"
         "Reddit")
        (orca-handler-match-url
         "https://emacs.stackexchange.com/"
         "~/Dropbox/org/wiki/emacs.org"
         "\\* Questions")
        (orca-handler-current-buffer
         "\\* Tasks")
        (orca-handler-file
         "~/Dropbox/org/ent.org"
         "\\* Articles")))

It’s also possible to customize interactively via M-x customize-group RET orca RET.

orca's Issues

undeclared dependencies

when building through guix' emacs-build-system:

In end of data:
orca.el:212:12: Warning: the function ‘counsel--sl’ is not known to be
    defined.
orca.el:179:23: Warning: the function ‘zo-left’ is not known to be defined.
orca.el:109:49: Warning: the function ‘url-host’ is not known to be defined.
orca.el:109:26: Warning: the function ‘url-type’ is not known to be defined.

which is weird at least for zo-left (declared).

There is also a call to ripgrep which is not declared. I'm working on a patch.

Question: How to capture from Browser

hello,
i just found your new package and tried it.
Looks interesting.

But i do not understand or found infos, how i could capture from a Browser.
Which Browser works?
Any plugins neccessary?

Regards
Poul

Please think about rename your package to org-<yourchoice>

This helps thousands of users to detect the relationship to the Org Universe. Undoubtedly at the first sight of the name via the all kown prefix org-.
"orca" sounds nice but doesn't show this dependency in the first moment.

Thanks

Package dependency missing: zoutline

zo-left is used at

orca/orca.el

Line 161 in de503d1

(zo-left 1))

without requiring zoutline package.

Since this is the only place zoutline's function is used, I thought you should decide whether make it a dependency or not.

orca does not work with google-chrome

Although having installed orca with my Emacs, and org-capture plugin with google-chrome, I find that it does not work. It does not match some URLs, for example, www.reddit.com.
My config is as follows:
;;{{ start
(require 'orca)
(setq orca-handler-list
'((orca-handler-match-url
"https://www.reddit.com/emacs/"
"/MEGA/org/wiki/emacs.org"
"Reddit")
(orca-handler-match-url
"https://emacs.stackexchange.com/"
"/MEGA/org/wiki/emacs.org"
"\* Questions")
(orca-handler-current-buffer
"\* Tasks")
(orca-handler-file
"~/MEGA/org/ent.org"
"\* Articles")))
;;end }}

Use variable or function for target org file

I try to use a variable or a function to specify
the org file target but it seems to be only working with a string?

(setq orca-handler-list
      '((orca-handler-match-url
         "https://www.reddit.com/r/emacs"
         (concat org-directory "refile.org") "\\* Reddit")  ;; Doesn't work
        (orca-handler-match-url
         "https://emacs.stackexchange.com/"
         org-default-notes-file "\\* Questions")      ;; Doesn't work
        (orca-handler-file
         "~/org/refile.org" "\\* Refile")))       ;; Works

In the message buffer I get
Greedy org-protocol handler. Killing client.

Thanks.