Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Take screenshot selection, upload to imgur. + more cool things
Shell
Branch: master

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
  • Very customizable
  • Edit image before uploading
  • Upload to your imgur account or anonymously
  • Create albums
  • Copy link to clipboard
  • Open uploaded image
  • Delete image from disk after upload
  • Filename, link, and deletion link history is stored
  • Automatically delete images after specified time
  • Get notifications about updates

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

Installation

Clone the repo and check if you have all dependencies 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 | --connect] | --check | [-v | --version] | [-h | --help]] | [[-o | --open <true|false>] [-e | --edit <true|false>] [-l | --login <true|false>] [[-a <album_title> | --album <album_title>] | [-A <album_id> | --album_id <album_id>]] [-k | --keep_file <true|false>] [-d <s> | --auto-delete <s>] [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
-o is equal to --open true
-e --edit override edit config
-e is equal to --edit true
-l --login override login config
-lis equal to --login true
-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 <s> --auto-delete <s> automatically delete image after s seconds
-u --update check for updates, exit
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 --connect # shows you which account you're connected to
imgur-screenshot.sh -l

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
Something went wrong with that request. Please try again.