Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/toolinbox/iPicUploader
Use iPic to upload images on macOS.
https://github.com/toolinbox/iPicUploader
Last synced: 12 days ago
JSON representation
Use iPic to upload images on macOS.
- Host: GitHub
- URL: https://github.com/toolinbox/iPicUploader
- Owner: toolinbox
- License: mit
- Created: 2016-09-04T03:28:32.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-04-29T09:38:21.000Z (over 5 years ago)
- Last Synced: 2024-10-25T16:41:01.463Z (19 days ago)
- Language: Swift
- Size: 687 KB
- Stars: 437
- Watchers: 9
- Forks: 35
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# iPic
iPic could automatically upload images and save Markdown links on macOS.
- Upload images by drag & drop.
- Upload images by services with shortcut `Command + U`.
- Upload copied images with shortcut `Shift + Command + U`.
- Support Imgur, Flickr, Amazon S3 and other image hosts.
- Support image link of Markdown format.
- [Video introduction](http://toolinbox.net/en/iPic/)
[Download iPic](https://itunes.apple.com/app/id1101244278?ls=1&mt=12) and have a try.
# iPicUploader
iPic opens the ability to upload images. It means if your App also needs to upload images, no need to build from scratch. Just use iPicUploader, your App could also upload images to Imgur, Flickr, Amazon S3 and other image hosts.
## iPicUploader Usage
Upload image file:
```swift
let imageFilePath = "/Path/to/the/pic.jpg"
iPic.uploadImage(imageFilePath, handler: { (imageLink, error) in
if let imageLink = imageLink {
// Image uploaded
} else if let error = error {
// Some error happened
}
})
```
Upload image data:
```swift
let imageFilePath = "/Path/to/the/pic.jpg"
let imageURL = URL(fileURLWithPath: imageFilePath)
let imageData = try! Data(contentsOf: imageURL)
iPic.uploadImage(imageData, handler: { (imageLink, error) in
if let imageLink = imageLink {
// Image uploaded
} else if let error = error {
// Some error happened
}
})
```
Upload NSImage:
```swift
let imageFilePath = "/Path/to/the/pic.jpg"
let image = NSImage(contentsOfFile: imageFilePath)
iPic.uploadImage(image, handler: { (imageLink, error) in
if let imageLink = imageLink {
// Image uploaded
} else if let error = error {
// Some error happened
}
})
```
## iPicUploader Example
iPicUploader also includes a full example. You will feel easy to start. To run the example project, just clone current repository and open *iPicUploader.xcworkspace*.
Note:
- As the demo needs to upload images by iPic, you need to [download iPic](https://itunes.apple.com/app/id1101244278?ls=1&mt=12) at first.
- No worry, you will also be guided to download iPic in the example.
- The example already dealt with these cases:
- If iPic wasn't installed, guide user to download.
- If iPic wasn't running, launch iPic automatically.
- If iPic is running but not compatible, guide user to download latest version.
Now, let's have a look how the example upload images.
### 1. Upload Images by Drag & Drop
As you can see, iPicUploader supports upload of multiple images at a time.
### 2. Upload Images by Select Images Files
### 3. Upload Images by Copy Image and Paste
Beside copy image files, you can also copy the image in other Apps to upload.
# Apps Using iPicUploader
It would be great to show your apps using iPicUploader here. Pull requests welcome :)
- [Typora](http://www.typora.io/)
## Requirements
As iPic runs on macOS 10.11 and newer version, iPicUploader also needs macOS 10.11+
## Installation
iPicUploader is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod "iPicUploader"
```
## License
iPicUploader is available under the MIT license.