Skip to main content

A Python module and app to print photos on the Fujifim Instax Printers

Project description

instax_api

.github/workflows/python-test.yml Coverage Status

This is a Python Module to interact and print photos to the Fujifilm Instax SP-2 and SP-3 printers.

Install this library

In order to use this library, you will need to be using Python 3

pip3 install instax-api

Usage

note - From version 0.7.0 to 0.8.0, I moved away from adding a script to just calling the module from pyton using the -m argument.

$ python3 -m instax.print --help
usage: instax-print [-h] [-i PIN] [-v {1,2,3}] image

positional arguments:
  image                 The location of the image to print.

optional arguments:
  -h, --help            show this help message and exit
  -i PIN, --pin PIN     The pin code to use, default: 1111.
  -v {1,2,3}, --version {1,2,3}
                        The version of Instax Printer to use (1, 2 or 3).
                        Default is 2 (SP-2).                       

Examples:

  • Printing a Photo to an SP-2 printer: python3 -m instax.print myPhoto.jpg
  • Printing a Photo to an SP-3 printer: python3 -m instax.print myPhoto.jpg -v 3
  • Printing a Photo to a printer with a pin that is not the default (1111) python3 -m instax.print myPhoto.jpg -i 1234

Hints and tips:

  • Make sure you are connected to the correct wifi network, once the printer is turned on, there will be an SSID / WiFi network available that starts with INSTAX- followed by 8 numbers. You'll need to connect to this.
  • If you have a static IP address set up on your computer, you'll need to turn on DHCP before attempting to print, the Instax printer will automatically assign you a new address once you connect.
  • Some Unix based operating systems may require you to use sudo in order to access the network.
  • The printer will automatically turn itself off after roughly 10 minutes of innactivity.
  • The instax.print utility will attempt to automatically rotate the image so that it either is correctly printed in portrait, or landscape with the thick bottom edge of the print on the left. If you wish to print your photos in a specific orientation that differs from this, then it's reccomended that you orient your photo in a tool like GIMP first, then strip out the rotation metadata. Once the rotation metadata has been stripped, the photo will need to be in a portrait orientation relative to the finished print (e.g. thick edge at the bottom).

Install Manually

git clone https://github.com/jpwsutton/instax_api.git
cd instax_api
python3 setup.py install

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

instax_api-0.8.0.tar.gz (1.7 MB view hashes)

Uploaded Source

Built Distribution

instax_api-0.8.0-py3-none-any.whl (1.7 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page