Alfred uploader

An Alfred workflow to help you upload local images or image from clipboard to cloud storage provider (support s3, upyun, qiniu now), and get back the public access url.

Markdown is a great language to write a document, and generate a good looking. But it is unpleasant when you insert a local image into your document. If I share the document including some local images with others, the images will be lost. So I should upload the images to a cloud storage provider at first, and copy back the access url into my document. It's so complicated and repetitive. The real terrible thing is to write a document, I want to insert a image, after I finished these fucking steps, back to the document, I have forgotten what to write.

Alfred is a efficient tool for Mac. There is a great feature called Workflows, we can create a workflow to do the complicated and repetitive work. I'm a heavy user of Alfred, I use it to find files, open apps, translate, calculate and so on. Only you can not think, no you can not do.

I can not stand to spend a lot of time waiting for the upload and copy again and again. So I create a workflow called Uploader to connect file input, image processing and url output.

With Uploader, if I want to insert a image while writing, use hotkey to open alfred, input "upload" keyword, select the image to upload, continue writing, just keep an eye on the upload success notification, paste the access url, that's all. My focus was always on the document I'm writing, alfred only disturbed for 1 to 3 seconds.

The all images in this document was uploaded by Uploader proudly. Now let me introduce Uploader to you, you can get it from alfred-uploader.

Download the latest release and double-click the workflow file (with a .alfredworkflow extension). Alfred will install it automatically.

After installed, you can find it in Alfred Preferences -> Workflows list.

Before we get started, we have to set some variables, click the "[x]" icon button specified with red arrow below.

Fill the variables into the right list on the pop-up modal, then save.

• UPLOAD_PROVIDER
  • Required
  • The cloud storage provider, such as: S3, Upyun, Qiniu...
  • Support s3 , upyun, qiniu now, all provider name shoud be lower case
• UPLOAD_HISTORY_COUNT
  • Optional, Default is 50
  • The maximum number of records to save
• USE_RAW_FILENAME
  • Optional, Default is fasle
  • Whether use the original filename
  • The image uploaded will be given a random numeric filename, looks like 147963249017197318.png.
  • If true, the image upload with the original filename, but some special chars (space and ?#%:) will replace with "_"
• The specific variables for s3
  • S3_BUCKET
    • Required
    • The bucket name
  • S3_REGION
    • Required
    • The region of the bucket. e.g. ap-southeast-1
  • S3_ACCESS_KEY
    • Required
    • Your AWS access key ID
  • S3_SECRET_KEY
    • Required
    • Your AWS secret access key
  • S3_BASEURL
    • Optinal, Default is the returned ObjectURL
    • The base url of the access url
    • You can change to the domain of yourself, only when you have config the CNAME redirector
• The specific variables for upyun
  • UPYUN_BUCKET
    • Required
    • The service name created at Upyun Console
  • UPYUN_USER
    • Required
    • The operator name
    • Make sure you have granted the operator reading and writing
  • UPYUN_PWD
    • Required
    • The operator password
    • Be careful, it saved as plain
  • UPYUN_USE_STREAM
    • Optional, Default is false
    • Whether enable stream mode
    • Upload with stream mode will save memory
  • UPYUN_BASEURL
    • Optinal, Default is http://{UPYUN_BUCKET}.b0.upaiyun.com
    • The base url of the access url
    • You can change to the domain of yourself, only when you have config the CNAME redirector
• The specific variables for qiniu
  • QINIU_BUCKET
    • Required
    • The bucket name
  • QINIU_ACCESS_KEY
    • Required
    • Your access key created at https://portal.qiniu.com/user/key
  • QINIU_SECRET_KEY
    • Required
    • Your secret key created at https://portal.qiniu.com/user/key
  • QINIU_BASEURL
    • Required
    • The base url of the access url
    • You can change to the domain of yourself, only when you have config the CNAME redirector

Attention:

• Don't export your secret variables, unless you want to share your storage.
• All BASEURL variable should be without the tail '/'.

Everything is ready. Let's upload.

There are three ways to upload:

1. Input "upload" keyword, pick a file. You can also filter the files with query.

2. locate a file in Alfred, select "Uploader" operation

3. select files in Finder, press hotkey "cmd+shift+s". I highly recommend this way, because it support multi files once.

Once you receive a notification said "😀Image upload complete", it means the local image has been uploaded to remote, and the access url is ready in your clipboard, you can paste it directly.

Tips: The first way, if you select a file with "alt (option)" key pressing, the result url will wrap a markdown img tag ()

Use "uploaded" keyword to lookup the uploaded images, keeping 50 records by default, query filter alse support.

As shown above, you can see the access url, the original file path and the upload time. Once you select a image, the access url copied, then paste it to anywhere you want. From last tips learned, the "alt" key also works here.

• support uploading image from clipboard (thanks @Tony Xu)

• support S3, Qiniu

Send me a pull request, or commit an issue.

MIT