https://github.com/LionyxML/ros

screenshot / copy & paste tool for org-mode files
https://github.com/LionyxML/ros

Last synced: about 2 months ago
JSON representation

screenshot / copy & paste tool for org-mode files

• Host: GitHub
• URL: https://github.com/LionyxML/ros
• Owner: LionyxML
• License: gpl-2.0
• Created: 2019-05-06T20:18:02.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-05-12T04:52:13.000Z (8 months ago)
• Last Synced: 2024-10-13T10:39:03.393Z (3 months ago)
• Language: Emacs Lisp
• Homepage:
• Size: 391 KB
• Stars: 127
• Watchers: 5
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# org-ros - Rahul's Org-mode Screenshot

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

My implementation for **"how do I copy-paste images into an org file?"** issue.

ros is invoked with M-x `org-ros` RET, it waits for your selection, takes a screenshot and saves it as `orgfileopened.org_YYYYMMDD_hhmmss.png`.

It then adds a link into your org file and turns ON `display-inline-images` showing you your image.

## Requirements

- Linux: scrot (for taking screenshots);

- MacOS: screencapture (built-in for Mojave, Catalina, Big Sur, Monterey...)

- Windows: powershell.exe (compatible with native Windows and WSL installations)

- Emacs: 24.1

## Install

`org-ros` is available on [MELPA](https://melpa.org/#/org-ros).

Alternatively, you can download `org-ros.el`, copy this file to a folder, like `~/.emacs.d/org-ros/`,

and add to your `.emacs` file:

```

(add-to-list 'load-path "~/.emacs.d/org-ros/")

(require 'org-ros)

```

## Usage

Use M-x `org-ros` RET, select the part of the screen you want to screenshot, and a picture file should be created and linked into your document.

## Screenshot

Here it's what it does.

![ros in action](images/ros.gif)