Skip to content
Take screenshot selection, upload to imgur. + more cool things
Find file
New pull request
Latest commit b788fa4 @jomo v1.6.0

The Imgur-Screenshot uploader for Linux & OS X from


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

screenshot gif


  • 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.


Install via Homewbrew:

brew update && brew install imgur-screenshot

Clone the repo and check if you have all dependencies installed: --check

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



Note: Check out the wiki for more! [--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

Uploading a screenshot to your account --connect # shows you which account you're connected to -l

Making a selection:


(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.


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.