https://github.com/abo-abo/org-download

Drag and drop images to Emacs org-mode
https://github.com/abo-abo/org-download

Last synced: about 1 month ago
JSON representation

Drag and drop images to Emacs org-mode

• Host: GitHub
• URL: https://github.com/abo-abo/org-download
• Owner: abo-abo
• Created: 2013-10-16T14:53:11.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2022-09-06T19:30:02.000Z (about 2 years ago)
• Last Synced: 2024-05-09T21:05:49.664Z (6 months ago)
• Language: Emacs Lisp
• Homepage:
• Size: 126 KB
• Stars: 1,033
• Watchers: 20
• Forks: 80
• Open Issues: 73
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# org-download

[![MELPA](https://melpa.org/packages/org-download-badge.svg)](https://melpa.org/#/org-download)

[![MELPA Stable](https://stable.melpa.org/packages/org-download-badge.svg)](https://stable.melpa.org/#/org-download)

This extension facilitates moving images from point **A** to point **B**.

Point **A** (*the source*) can be:

1. An image inside your browser that you can drag to Emacs.

2. An image on your file system that you can drag to Emacs.

3. A local or remote image address in kill-ring.

   Use the `org-download-yank` command for this.

   Remember that you can use "0 w" in `dired` to get an address.

4. A screenshot taken using `gnome-screenshot`, `scrot`, `gm`, `xclip`

   (on Linux), `screencapture` (on OS X) or , `imagemagick/convert`

   (on Windows).  Use the `org-download-screenshot` command for this.

   Customize the backend with `org-download-screenshot-method`.

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.

They are:

`org-download-method`:

1. 'attach => use `org-mode` attachment machinery

2. 'directory => construct the directory in two stages:

   1. first part of the folder name is:

      * either "." (current folder)

      * or `org-download-image-dir` (if it's not nil).

        `org-download-image-dir` becomes 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")

   2. second part is:

      * `org-download-heading-lvl` is nil => ""

      * `org-download-heading-lvl` is 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-lvl` becomes buffer-local when set,

        so each file can customize this value, e.g with:

                -*- mode: Org; org-download-heading-lvl: nil; -*-

`org-download-timestamp`:

optionally add a timestamp to the file name.

Customize `org-download-backend` to choose between `url-retrieve`

(the default) or `wget` or `curl`.

## Set up

```elisp

(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 `org-download-clipboard`.