Protocol Launcher

Picsew ​

Picsew is a screenshot stitching app for iOS. Protocol Launcher allows you to generate Picsew x-callback-url links.

Usage ​

There are two ways to use this library:

  • On-Demand import from subpaths enables tree-shaking and keeps bundles small.
  • Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand
Recommended. Optimized for production.
Full Import
Convenient. Good for quick scripts.

Notes ​

Picsew's official x-callback-url documentation defines three actions: /scroll, /vert, and /hori. This module exposes only those documented actions as scroll(), vert(), and hori().

Picsew 3.18.1+ adds mockupName (mockup-name) and mockupBackgroundWidth (mockup-background-width, an integer from 0 to 100). mockup2 remains a compatible alias. The payload also supports: in, count when in=latest, out, watermark, border, mockup2, clean_status, remove_scrollbar, and delete_source. The older mockup parameter still prompts an upgrade and should be avoided in new URLs.

Scrollshot Stitching ​

Use the specified images for Picsew Scrollshot Stitching.

On-Demand
ts
import { scroll } from 'protocol-launcher/picsew'

const url = scroll({
  in: 'recent',
  out: 'save',
  clean_status: 'yes',
  mockupName: 'iphone-air-sky-blue',
  mockupBackgroundWidth: 50,
  delete_source: 'yes',
})
Create Scrollshot Stitching URL

Vertical Stitching ​

Use the specified images for Picsew Vertical Stitching.

On-Demand
ts
import { vert } from 'protocol-launcher/picsew'

const url = vert({
  in: 'latest',
  count: 3,
  out: 'copy',
  watermark: 'repeat',
})
Create Vertical Stitching URL

Horizontal Stitching ​

Use the specified images for Picsew Horizontal Stitching.

On-Demand
ts
import { hori } from 'protocol-launcher/picsew'

const url = hori({
  in: 'paste',
  out: 'copy',
})
Create Horizontal Stitching URL

Generated URLs ​

ts
scroll({
  in: 'recent',
  out: 'save',
  clean_status: 'yes',
  mockupName: 'iphone-air-sky-blue',
  mockupBackgroundWidth: 50,
  delete_source: 'yes',
})
// => 'picsew://x-callback-url/scroll?in=recent&out=save&clean_status=yes&mockup-name=iphone-air-sky-blue&mockup-background-width=50&delete_source=yes'

vert({
  in: 'latest',
  count: 3,
  out: 'copy',
  watermark: 'repeat',
})
// => 'picsew://x-callback-url/vert?in=latest&count=3&out=copy&watermark=repeat'

hori({
  in: 'paste',
  out: 'copy',
})
// => 'picsew://x-callback-url/hori?in=paste&out=copy'

Official Documentation ​