⬆ A simple Mac app designed to make uploading images and screenshots to Imgur quick and effortless.
mac2imgur
:warning: Warning: This project is not currently actively maintained. :warning:
A simple Mac application designed to make uploading images and screenshots to imgur.com quick and effortless.
Installation
Download the latest release (macOS 10.9+)
Usage
The application will listen for new screenshots taken by the built in screenshot functionality of macOS, so you can use the following shortcuts to capture your screen:
Press CMD ⌘ + SHIFT ⇧ + 3 to take a full-screen screenshot
Press CMD ⌘ + SHIFT ⇧ + 4 to take a rectangular selection of the screen
Press CMD ⌘ + SHIFT ⇧ + 4 + SPACE to capture a specific window or menu
In addition, images can be uploaded manually by either:
As soon as an image is uploaded, the link is copied to your clipboard and a notification is sent:
Application Preferences General
Preference Name Description Issue ID
Launch at Login
Allows mac2imgur to start as soon as you log in - this can also be changed from the Login Items
tab of the Users & Groups
pane of System Preferences
.
#53
Clear Clipboard Clears the clipboard when an upload is taking place. #77
Copy Link to Clipboard Copies the direct link to the uploaded image, if the upload completes successfully. #88
Screenshots
Preference Name Description Issue ID
Delete After Upload Causes the original screenshot file to be moved to trash after attempting to upload. #23
Disable Detection Any new screenshots taken are ignored by the application and not uploaded. #30
Request Confirmation Before Upload Screenshots are not uploaded automatically. Instead, an alert is displayed, showing the image and image name, allowing you to either proceed or cancel. #38
Downscale from Retina Retina screenshots are resized (reducing resolution) before upload. More Info.
System Preferences
Some aspects of the system screenshot functionality can be customized through defaults
, including the following options:
Key Value Result
location
Any path, e.g. /Users/[username]/Pictures
Screenshots will be saved to the specified location, if it is valid. Otherwise, the default location (typically ~/Desktop
) will be used.
type
png
, jpg
, gif
, tiff
etc
The screenshot will be saved in the specified format.
name
Any string, e.g. My Screenshot
The screenshot file will be prefixed with the specified name, e.g. My Screenshot 2016-07-10 at 17.42.17
.
You can modify the defaults easily from Terminal.app
:
defaults write com.apple.screencapture <key> <value>
defaults delete com.apple.screencapture <key>
Examples
Save screenshots using the JPG
format:
defaults write com.apple.screencapture type jpg
Revert the screenshot save location back to the system default:
defaults delete com.apple.screencapture location
Further Information
More about defaults
can be found from defaults --help
and man defaults
.
For any changes to take effect, you must restart SystemUIServer
, which can be done through Activity Monitor.app
or by running a command such as killall SystemUIServer
.
When changing the screenshot location, it is also necessary to restart mac2imgur.
Support
If you encounter any problems or have an idea for a new feature, don't hesitate to file an issue - but please be as descriptive as possible!
On the same note, pull requests to fix bugs, add features or simply to improve the codebase are greatly appreciated.
Development
Legal
mac2imgur is not affiliated with Imgur LLC, but this application would not be possible without the awesome service they offer - so feel free to show them some appreciation! 👍
This application is released under a GPLv3 license. See LICENSE for more information.
Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.
We'll never share your email with anyone else.