Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jomo/imgur-screenshot
Take screenshot selection, upload to imgur. + more cool things
https://github.com/jomo/imgur-screenshot
cli imgur screenshot unix upload
Last synced: about 1 month ago
JSON representation
Take screenshot selection, upload to imgur. + more cool things
- Host: GitHub
- URL: https://github.com/jomo/imgur-screenshot
- Owner: jomo
- License: mit
- Archived: true
- Created: 2013-11-10T20:12:18.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2021-08-21T05:01:26.000Z (about 3 years ago)
- Last Synced: 2024-05-22T20:34:58.150Z (4 months ago)
- Topics: cli, imgur, screenshot, unix, upload
- Language: Shell
- Homepage:
- Size: 200 KB
- Stars: 565
- Watchers: 18
- Forks: 84
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
The _**Imgur-Screenshot**_ uploader for Linux & OS X from [imgur.com/tools](https://imgur.com/tools)
# Imgur-Screenshot
1. select area of your screen
1. The screenshot is uploaded to [imgur](https://imgur.com)
## 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](http://www.imagemagick.org/script/index.php), or just to quickly add notes.
## Contributing
* Report [issues](https://github.com/jomo/imgur-screenshot/issues)
* Submit feature request
* Make a pull request
* Get imgur-screenshot on more package managers!
See also: [CONTRIBUTING.md](CONTRIBUTING.md)
## Installation
### Install on Mac via Homebrew
```shell
brew update && brew install imgur-screenshot
```
### Install on ArchLinux via AUR
See [imgur-screenshot](https://aur.archlinux.org/packages/imgur-screenshot/) for the stable version, and [imgur-screenshot-git](https://aur.archlinux.org/packages/imgur-screenshot-git/) for the development version.
### Install on CentOS and Fedora via COPR
See [valdikss/imgur-screenshot](https://copr.fedorainfracloud.org/coprs/valdikss/imgur-screenshot/) on COPR.
### Install on NixOS via Nix
See [imgur-screenshot](http://hydra.nixos.org/search?query=imgur-screenshot) on Hydra.
### Install via git
```shell
git clone https://github.com/jomo/imgur-screenshot.git
```
### Download source
Alternatively, you can download `imgur-screenshot` from [releases](https://github.com/jomo/imgur-screenshot/releases).
These builds have [auto-update.patch](auto-update.patch) applied, allowing to update via `--update`.
---
Make sure you have all dependencies installed (see below).
That's it.
Bind the script to a hotkey or add it to your `$PATH` for quick access ;)
**Enjoy!**
## Usage
> **Note:** You can override the default configuration in `~/.config/imgur-screenshot/settings.conf`.
> Check out [the wiki](https://github.com/jomo/imgur-screenshot/wiki/Config) for more!
```shell
imgur-screenshot [--debug] [-c | -v | -h | -u]
imgur-screenshot [--debug] [optiion]... [file]...
```
Run `imgur-screenshot -h` to see all command line options.
### Uploading a screenshot
All you need to do is simply run `imgur-screenshot`.
### Uploading a screenshot to your account
```shell
imgur-screenshot -c # shows you which account you're connected to
imgur-screenshot -l true
```
---
## Dependencies
* curl
* jq
* **Linux only:**
* libnotify-bin
* scrot (or other screenshot tool)
* xclip (needed for `copy_url`)
* **macOS only:**
* [terminal-notifier](https://github.com/julienXX/terminal-notifier) *or* [growlnotify](http://growl.info/downloads#generaldownloads)
## OS support
With the above dependencies installed, imgur-screenshot should work on most UNIX systems.
This will not work on Windows. (maybe with cygwin?)
I have successfully tested this on Ubuntu and macOS.
If this won't work on your OS, [create a new issue](https://github.com/jomo/imgur-screenshot/issues/new?title=add+support+for+_______&body=required+steps+to+make+it+work+on+______:).
## 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.