This extension facilitates moving images from point A to point B.
Point A (the source) can be:
- An image inside your browser that you can drag to Emacs.
- An image on your file system that you can drag to Emacs.
- A local or remote image address in kill-ring.
org-download-yankcommand for this. Remember that you can use "0 w" in
diredto get an address.
- A screenshot taken using
screencapture(on OS X) or ,
imagemagick/convert(on Windows). Use the
org-download-screenshotcommand for this. Customize the backend with
Point B (the target) is an Emacs
org-mode buffer where the inline
link will be inserted. Several customization options will determine
where exactly on the file system the file will be stored.
- 'attach => use
- 'directory => construct the directory in two stages:
first part of the folder name is:
either "." (current folder)
org-download-image-dir(if it's not nil).
org-download-image-dirbecomes buffer-local when set, so each file can customize this value, e.g with:
-*- mode: Org; org-download-image-dir: "~/Pictures/foo"; -*-
To set it for all files at once, use this:
(setq-default org-download-image-dir "~/Pictures/foo")
second part is:
org-download-heading-lvlis nil => ""
org-download-heading-lvlis n => the name of current heading with level n.
Level count starts with 0, i.e. * is 0, ** is 1, *** is 2 etc.
org-download-heading-lvlbecomes buffer-local when set, so each file can customize this value, e.g with:
-*- mode: Org; org-download-heading-lvl: nil; -*-
optionally add a timestamp to the file name.
org-download-backend to choose between
(the default) or
(require 'org-download) ;; Drag-and-drop to `dired` (add-hook 'dired-mode-hook 'org-download-enable)
Pasting from the clipboard
If you have the image stored in the clipboard, use