Skip to main content

A simple CLI that uploads your image in the clipboard to Imgur.

Project description

clip2imgur

A simple macOS command line tool for uploading your screenshots from clipboard to Imgur

Github Actions Status License pypi DOI

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.<img src="https://i.imgur.com/x.png">
-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:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clip2imgur-0.9.4.tar.gz (12.4 kB view details)

Uploaded Source

Built Distribution

clip2imgur-0.9.4-py2.py3-none-any.whl (12.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file clip2imgur-0.9.4.tar.gz.

File metadata

  • Download URL: clip2imgur-0.9.4.tar.gz
  • Upload date:
  • Size: 12.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.14

File hashes

Hashes for clip2imgur-0.9.4.tar.gz
Algorithm Hash digest
SHA256 984888f5aa406ef4d749cad201af352846e784d681162a346e468ab380f7323c
MD5 406815264d8f0fb6fb501d8ae15639ef
BLAKE2b-256 37eefc6c8603e3e79efb2a30bfa4ae8b51ece0a86be47a5597272ef0aeb36828

See more details on using hashes here.

File details

Details for the file clip2imgur-0.9.4-py2.py3-none-any.whl.

File metadata

  • Download URL: clip2imgur-0.9.4-py2.py3-none-any.whl
  • Upload date:
  • Size: 12.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.14

File hashes

Hashes for clip2imgur-0.9.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 f70818eeb45db4d8a311b3562cb255c17f42bff63db32cf0346cdbbf3c1bffbf
MD5 f525d1358f1b5c250ca7c2688b1c2df1
BLAKE2b-256 377e37f7227426e0b0e097ec428052346af4203069b72f9df5b63ae1d09d0843

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page