X-Callback-URL

Picsew implements the x-callback-url protocol, a generic URL Scheme protocol. It allows you to communicate between different apps. Workflow, Launch Center Pro and other apps support x-callback-url, so Picsew also supports working with them.

Picsew's x-callback-url format is:

picsew://x-callback-url/[action]?[action parameters]&[x-callback parameters]

Action

/scroll

Use the specified images for Scrollshot Stitching.

/vert

Use the specified images for Vertical Stitching.

/hori

Use the specified images for Horizontal Stitching.

Action Parameters

  • in (Required) Specifies how to get the input image. The allowed values ​​are paste, latest, and recent. When paste, get the images from the clipboard. When latest, get the latest N images of the photo album, and N is determined by another parameter count. When recent, the most recent screenshots are automatically detected.

  • count When in=latest, this is a required parameter, specify the number of images to get.

  • out (Required) Specifies how to output the stitching result. The allowed values are copy, save and save_copy. When copy, copy the result to the clipboard. When save, save the result to the photo album. When save_copy, save and copy the result.

  • watermark (optional) Specifies whether to add watermark. The allowed values ​​are single and repeat. By default, no watermark is added. Both watermark text and location use the default watermark setting in the App. If default setting not configure properly, the final result will not have a watermark. When single, add a single watermark to the default position of the result image. When repeat, a watermark is added to the default position of each image.

  • border (optional) Specify whether to add borders. The allowed values are inside, outside and all. By default, no border is added. When inside, add borders inside the result image. When outside, add borders outside the result image. When all, add borders inside and outside the result image. If you want to specify the width, you can add _<0~100> at the end, for example inside_60.

  • mockup (optional) Specify whether to add the device mockup. The format of allowed values is <color>[_<model>]. The allowed values of <color> ​​are white and black. The allowed values of <model> are iphonex, iphonexr, iphone, ipad and watch. The mockup is not added by default. The mockup model is automatically selected to be the same model with current device if not specify <model>.

    The relationship between the parameter color and the actual color is as follows:

Model White Black
iPhone X Silver Space Gray
iPhone XR Blue Blue
iPhone Gold Space Gray
iPad Rose Gold Space Gray
Watch White Black

Here are some examples:

Example Model and Color
white_iphonex Silver Color iPhone X
white_iphonexr Blue Color iPhone X
black_iphone Space Gray Color iPhone
white_ipad Rose Gold Color iPad
black_watch Black Color Apple Watch
  • clean_status (optional) Specifies whether the status bar needs to be cleared. When yes, the status bar is automatically cleared. The default is not clear.

  • delete_source (optional) Specifies whether the source images needs to be deleted. When yes, the source images will be deleted. It is not deleted by default.

Examples

  • Use the most recent screenshots for scrollshot stitching, automatically clear the status bar, and add a white device mockup, save the results to the photo album, and then delete the source images.
picsew://x-callback-url/scroll?in=recent&out=save&clean_status=yes&mockup=white&delete_source=yes
  • Vertical stitching using the latest 3 images of the photo album, add a default watermark to each image, copy the result to the clipboard.
picsew://x-callback-url/vert?in=latest&count=3&out=copy&mockup=white

Workflow Examples

Make Scrollshot widet

This workflow allows you to select a number of latest screenshots, run Picsew to automatically stitching them together, save the result to the photo album, then return to Workflow, check the result, delete the source images.

Recent Scrollshot widget

This workflow will automatically detect recent screenshots, run Picsew to automatically stitching them together, adding mockup or cleaning status bar by your selection, save the result to the photo album, delete the source images, then return to Workflow, check the result.

Create Scrollshot action

This workflow use your selected screenshots as input, run Picsew to automatically stitching them together, adding mockup or cleaning status bar by your selection, save the result to the photo album, then return to Workflow, check the result, delete the source images.

Change Log

App Version Category Details
2.7.2 New Action Parameter Add border
2.8 New Action Parameter Value Add model selection to mockup
2.10 New Action Parameter Value border Add Outer Border and Border Width Settings

results matching ""

    No results matching ""