Awesome
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 <kbd>CMD ⌘</kbd> + <kbd>SHIFT ⇧</kbd> + <kbd>3</kbd> to take a full-screen screenshot
-
Press <kbd>CMD ⌘</kbd> + <kbd>SHIFT ⇧</kbd> + <kbd>4</kbd> to take a rectangular selection of the screen
-
Press <kbd>CMD ⌘</kbd> + <kbd>SHIFT ⇧</kbd> + <kbd>4</kbd> + <kbd>SPACE</kbd> to capture a specific window or menu
In addition, images can be uploaded manually by either:
- Dragging and dropping images on the status bar icon (macOS 10.10+)
- Clicking the "Upload Images…" option in the status bar menu
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. | #52 |
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
- Written in Swift 3
- CocoaPods for dependency management
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! :+1:
This application is released under a GPLv3 license. See LICENSE for more information.