https://github.com/xiaohk/clip2imgur
A simple macOS command line tool for uploading your screenshots from clipboard to Imgur
https://github.com/xiaohk/clip2imgur
cli imgur macos swift
Last synced: 2 months ago
JSON representation
A simple macOS command line tool for uploading your screenshots from clipboard to Imgur
- Host: GitHub
- URL: https://github.com/xiaohk/clip2imgur
- Owner: xiaohk
- License: mit
- Created: 2018-02-09T23:24:35.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-11T16:16:22.000Z (over 1 year ago)
- Last Synced: 2025-04-12T10:02:51.435Z (6 months ago)
- Topics: cli, imgur, macos, swift
- Language: Swift
- Homepage:
- Size: 1.09 MB
- Stars: 18
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
clip2imgur 
> A simple macOS command line tool for uploading your screenshots from clipboard
> to Imgur
[](https://github.com/xiaohk/clip2imgur/actions/workflows/build.yml)
[](https://github.com/xiaohk/clip2imgur/blob/master/LICENSE)
[](https://pypi.python.org/pypi/clip2imgur)
[](https://doi.org/10.5281/zenodo.5348350)
## Usage
- Press control+shift+command+3 or control+shift+command+4
to capture and copy a screenshot.
- Run `clip2imgur` in your terminal, then boom, the image URL is in your
clipboard.
- If it is your first time to run `clip2imgur`, you can choose to authorize this
tool, and your image will be posted in your image collection
(`username.imgur.com/all`).
- You also can choose to post anonymously, but it is hard to get the url later
and Imgur might delete your posts.
In default setting, the URL of posted image will be copied to your clipboard.
You can use flags to configure it.
```
$ clip2imgur --html
$ clip2imgur -n
```
| short | long | description |
| :---- | :----------- | :---------------------------------------------------------------------------------- |
| `-m` | `--markdown` | URL will be copied in the Markdown image format.`[](https://i.imgur.com/x.png)` |
| `-t` | `--html` | URL will be copied in the HTML image format.`
` |
| `-n` | `--notcopy` | Your image URL will not be copied to your clipboard |
| `-a` | `--anon` | Post the image anonymously |
Personally I like to include images in Markdown file using the HTML format,
which gives more control of the display. If you forget these flags, you always
can run `clip2imgur -h` to check the usage.
## Change Log
- (4/9/2024): Clip2imgur is rewritten in Python.
- (2/15/2018): Clip2imgur is released. This version is written in Swift.
## Install
This package is built using cross-platform Swift with Swift Package Manager
(SPM), but it currently only supports macOS. There are three ways to install
`clip2imgur`.
### Homebrew
Using `Homebrew` is the recommended and also the easiest way to get `clip2imgur`
installed on your mac. If you don't have `Homebrew` installed, you can simply
run:
```
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
Then, to install `clip2imgur`:
```
$ brew tap xiaohk/clip2imgur
$ brew install clip2imgur
```
### PyPI
If you are familiar with Python, you can install `clip2imgur` with pip.
```
$ pip install clip2imgur
```
## Built With
The latest version (>=v0.9.1) uses Python.
The first version (v0.9.0) was built with:
- [Swift Package Manager](https://swift.org/package-manager/)
- [Rainbow](https://github.com/onevcat/Rainbow)