Take screenshot selection, upload to imgur. + more cool things
Shell
Latest commit 6a4433a Jul 28, 2016 @jomo committed on GitHub Merge pull request #86 from vitorgalvao/patch-1
README.md: fix typo

README.md

The Imgur-Screenshot uploader for Linux & OS X from imgur.com/tools

Imgur-Screenshot

  1. select area of your screen
  2. The screenshot is uploaded to imgur

screenshot gif

Features

  • Upload screenshot or image files
  • Copy link to clipboard
  • Customizable configuration
  • Edit image before uploading
  • Upload anonymously or to an account
  • Create and add to albums
  • Filename, link, and deletion link history is stored
  • Automatic image deletion
  • Update notifications

The edit feature can be used for automated editing with something like ImageMagick, or just to quickly add notes.

Installation

Install on Mac via Homebrew

brew update && brew install imgur-screenshot

Install on ArchLinux via AUR

See the imgur-screenshot-git package.

Install on CentOS and Fedora via COPR

See valdikss/imgur-screenshot on COPR.

Install on NixOS via Nix

See imgur-screenshot on Hydra.

Install via git

git clone https://github.com/jomo/imgur-screenshot.git

Download source

Alternatively, you can download imgur-screenshot.sh from releases.
These builds have auto-update.patch applied, allowing to update via --update.


To check if all dependencies are installed:

imgur-screenshot.sh --check

That's it.
Bind the script to a hotkey or add it to your $PATH for quick access ;)

Enjoy!

Usage

Note: Check out the wiki for more!

imgur-screenshot.sh [--debug] [-c | --check | -v | -h | -u]
imgur-screenshot.sh [--debug] [optiion]... [file]...
short command description
--debug Enable debugging. Must be the first option!
Remember to remove credentials before pasting!
-h --help Show help, exit
-v --version Print current version, exit
--check Check if all dependencies are installed, exit
-c --connect Show connected imgur account, exit
-o --open override open config
-e --edit override edit config
-l --login override login config
-a --album <album_title> Create new album and upload there
-A --album-id <album_id> override album_id config
-k --keep-file override keep_file config
-d --auto-delete <s> automatically delete image after s seconds
-u --update check for updates, exit.
Release versions also apply found updates.
This is done automatically when check_update and auto_update are set to true.
file ... instead of uploading a screenshot, upload file

Uploading a screenshot

All you need to do is simply run imgur-screenshot.sh.

Uploading a screenshot to your account

imgur-screenshot.sh -c # shows you which account you're connected to
imgur-screenshot.sh -l true

Making a selection:
Selection

Dependencies

(Most are probably pre-installed)
Tip: Use --check to see what's missing.

OS support

This will not work on Windows. (maybe with cygwin?)
I have successfully tested this on Ubuntu and OS X.
If this won't work on your OS, create a new issue.

Note

The screenshot will be taken after the selection has been made. This might be annoying if you want to capture something quickly and then want to select an area. However, you can take a full shot and use the edit option to crop the image before upload.

How to contribute

  • Report issues
  • Submit feature request
  • Make a pull request
  • Buy me a beer: 1jomojdTww1vnNwvseLrKgTENZoojQ3Um