{"id":13634398,"url":"https://github.com/mileswd/mac2imgur","last_synced_at":"2025-04-04T07:06:35.375Z","repository":{"id":11150045,"uuid":"13518840","full_name":"mileswd/mac2imgur","owner":"mileswd","description":"⬆ A simple Mac app designed to make uploading images and screenshots to Imgur quick and effortless.","archived":false,"fork":false,"pushed_at":"2019-02-16T11:38:24.000Z","size":17839,"stargazers_count":966,"open_issues_count":23,"forks_count":98,"subscribers_count":25,"default_branch":"master","last_synced_at":"2025-03-28T06:07:14.594Z","etag":null,"topics":["capture","imgur","mac","screenshot","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mileswd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-10-12T08:42:42.000Z","updated_at":"2025-03-21T06:27:27.000Z","dependencies_parsed_at":"2022-07-12T15:04:12.376Z","dependency_job_id":null,"html_url":"https://github.com/mileswd/mac2imgur","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mileswd%2Fmac2imgur","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mileswd%2Fmac2imgur/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mileswd%2Fmac2imgur/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mileswd%2Fmac2imgur/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mileswd","download_url":"https://codeload.github.com/mileswd/mac2imgur/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247135144,"owners_count":20889421,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["capture","imgur","mac","screenshot","swift"],"created_at":"2024-08-01T23:01:03.919Z","updated_at":"2025-04-04T07:06:35.347Z","avatar_url":"https://github.com/mileswd.png","language":"Swift","readme":"# mac2imgur\n\n:warning: Warning: This project is not currently actively maintained. :warning:\n\n![mac2imgur running on macOS Yosemite](https://i.imgur.com/WrMhzbe.png)\n\nA simple Mac application designed to make uploading images and screenshots to [imgur.com](https://imgur.com) quick and effortless.\n\n## Installation\n\n[Download the latest release](https://github.com/mileswd/mac2imgur/releases/latest) (macOS 10.9+)\n\n## Usage\n\nThe application will listen for new screenshots taken by the [built in screenshot functionality of macOS](https://support.apple.com/kb/ht5775), so you can use the following shortcuts to capture your screen:\n\n- Press \u003ckbd\u003eCMD ⌘\u003c/kbd\u003e + \u003ckbd\u003eSHIFT ⇧\u003c/kbd\u003e + \u003ckbd\u003e3\u003c/kbd\u003e to take a full-screen screenshot\n\n- Press \u003ckbd\u003eCMD ⌘\u003c/kbd\u003e + \u003ckbd\u003eSHIFT ⇧\u003c/kbd\u003e + \u003ckbd\u003e4\u003c/kbd\u003e to take a rectangular selection of the screen\n\n- Press \u003ckbd\u003eCMD ⌘\u003c/kbd\u003e + \u003ckbd\u003eSHIFT ⇧\u003c/kbd\u003e + \u003ckbd\u003e4\u003c/kbd\u003e + \u003ckbd\u003eSPACE\u003c/kbd\u003e to capture a specific window or menu\n\nIn addition, images can be uploaded manually by either:\n\n- Dragging and dropping images on the status bar icon  (macOS 10.10+)\n- Clicking the \"Upload Images…\" option in the status bar menu\n\nAs soon as an image is uploaded, the link is copied to your clipboard and a notification is sent:\n![mac2imgur upload notification](https://i.imgur.com/V2PTN1l.png)\n\n## Application Preferences\n\n### General\n\n| Preference Name | Description | Issue ID |\n| --------------- | ----------- | -------- |\n| 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 \u0026 Groups` pane of `System Preferences`. | [#53](https://github.com/mileswd/mac2imgur/issues/53) |\n| Clear Clipboard | Clears the clipboard when an upload is taking place. | [#77](https://github.com/mileswd/mac2imgur/issues/77) |\n| Copy Link to Clipboard | Copies the direct link to the uploaded image, if the upload completes successfully. | [#88](https://github.com/mileswd/mac2imgur/issues/88) |\n\n### Screenshots\n\n| Preference Name | Description | Issue ID |\n| --------------- | ----------- | -------- |\n| Delete After Upload | Causes the original screenshot file to be moved to trash after attempting to upload. | [#23](https://github.com/mileswd/mac2imgur/issues/23) |\n| Disable Detection | Any new screenshots taken are ignored by the application and not uploaded. | [#30](https://github.com/mileswd/mac2imgur/issues/30) |\n| 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](https://github.com/mileswd/mac2imgur/issues/38) |\n| Downscale from Retina | Retina screenshots are resized (reducing resolution) before upload. [More Info.](https://cloudup.com/blog/the-retina-screenshot-problem) | [#52](https://github.com/mileswd/mac2imgur/issues/52) |\n\n## System Preferences\n\nSome aspects of the system screenshot functionality can be customized through `defaults`, including the following options:\n\n| Key | Value | Result |\n| --- | ----- | ------ |\n| 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. |\n| type | `png`, `jpg`, `gif`, `tiff` etc | The screenshot will be saved in the specified format. |\n| 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`. |\n\nYou can modify the defaults easily from `Terminal.app`:\n\n`defaults write com.apple.screencapture \u003ckey\u003e \u003cvalue\u003e`\n\n`defaults delete com.apple.screencapture \u003ckey\u003e`\n\n### Examples\n\nSave screenshots using the `JPG` format:\n\n`defaults write com.apple.screencapture type jpg`\n\nRevert the screenshot save location back to the system default:\n\n`defaults delete com.apple.screencapture location`\n\n### Further Information\n\nMore about `defaults` can be found from `defaults --help` and `man defaults`.\n\nFor 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`.\n\nWhen changing the screenshot location, it is also necessary to restart mac2imgur.\n\n## Support\n\nIf you encounter any problems or have an idea for a new feature, don't hesitate to [file an issue](https://github.com/mileswd/mac2imgur/issues) - but please be as descriptive as possible! \n\nOn the same note, pull requests to fix bugs, add features or simply to improve the codebase are greatly appreciated.\n\n## Development\n\n- Written in Swift 3\n- [CocoaPods](https://cocoapods.org) for dependency management\n\n## Legal\n\nmac2imgur 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:\n\nThis application is released under a GPLv3 license. See [LICENSE](https://github.com/mileswd/mac2imgur/blob/master/LICENSE) for more information.\n","funding_links":[],"categories":["Applications","Swift","Sharing Files","Why?"],"sub_categories":["Sharing Files","Text","📤 Sharing Files (9)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmileswd%2Fmac2imgur","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmileswd%2Fmac2imgur","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmileswd%2Fmac2imgur/lists"}