The Imgur-Screenshot uploader for Linux & OS X from imgur.com/tools
Imgur-Screenshot
- select area of your screen
- The screenshot is uploaded to imgur
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 --checkThat'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 -lDependencies
(Most are probably pre-installed)
Tip: Use --check to see what's missing.
- curl
- grep
- Linux only:
- libnotify-bin
- scrot
- xclip (needed for
copy_url) - OS X only:
- terminal-notifier or growlnotify
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

