Code Monkey home page Code Monkey logo

mac2imgur's Introduction

mac2imgur

⚠️ Warning: This project is not currently actively maintained. ⚠️

mac2imgur running on macOS Yosemite

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:

  • 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: mac2imgur upload notification

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! 👍

This application is released under a GPLv3 license. See LICENSE for more information.

mac2imgur's People

Contributors

dexafree avatar prashantvc avatar mileswd avatar vincentriemer avatar

Watchers

James Cloos avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.