Skip to main content

Join Messenger conversation screenshots.

Project description

Stitcher is a command-line utility for joining Messenger conversation screenshots.


$ pip install stitcher


General usage:

$ stitch <profile> <outfile> <images>...

Combine IMG_0001.PNG and IMG_0002.PNG taken on an iPhone 5S, saving the result to composition.png:

$ stitch IPHONE_5S composition.png IMG_0001.PNG IMG_0002.PNG IMG_0003.PNG

Combine all .png files in the present working directory using the profile for LG’s G3 phone, outputting to combined.png:

$ stitch LG_G3 combined.png *.png


Profiles define parameters used by Stitcher to join images. They are stored within the profiles directory, organised by device manufacturer. The following options can be specified:





The image format



The number of pixels of vertical height to crop from the top of the image



The number of pixels of vertical height to crop from the bottom of the image

Same as header_height


The vertical spacing between messages from the same sender



The vertical spacing between two messages sent by different participants

Same as additional_message_gap

If you’d like to add a missing a profile for your device, create a new file if necessary, and add a dictionary with the device’s details. Please consider contributing it in a pull request so others may benefit!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stitcher-0.0.1.tar.gz (10.6 kB view hashes)

Uploaded source

Built Distribution

stitcher-0.0.1-py2.py3-none-any.whl (15.4 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page