Instagram -> Pixelfed Mirror in Python (3+)

This Python scripts with a simple HTTP API to use it, can mirror multiple accounts from Instagram to your Pixelfed instance.

Disclaimer

Mirroring Instagram accounts will copy (clone) the images and videos from Instagram to your server, thus moving the data sovereignty to you as an Admin.

Always make sure you mirror accounts whos content is not strictly copyrighted (or branded) and keep the tagging system of the source code that marks accounts on Pixelfed as Mirrors.

Users of your Pixelfed instance have to know this accounts are not real accounts as someone on Instagram could create a real Pixelfed account in the future.

Pre-requisites

• You need an Instagram account to make this bot work.
• A Pixelfed instance you own. It must be hosted or managed by you (you need shell access for php artisan commands)
• Python 3+ installed on the same machine as the Pixelfed instance (this is easy, mostly all standard Debian based Linux systems have python3)
• A bit more disk space for Pixelfed media storage. (It depends on how many accounts you mirror and how often that accounts post on IG)
• Patch 1 file on Pixelfed deployed code (being on docker or not)

What can you mirror?

• Posts with images (multiple images support).
• Posts with videos (only 1 video).
• Each posts captions (post description) is represented as splitted comments.

What can't you mirror (yet) ?

• Stories. (will support that soon)

Installation

Patch some files

As i said on the Pre-requisites, you will need to patch the following files on Pixelfed running code:

This patch is needed to disable Pixelfed API rate limiting completely as it might pop-up when using your mirror bot. We asume your Pixelfed installation is at /var/www (if it isn't, just change the steps to match your installation)

/var/www/vendor/laravel/framework/src/Illuminate/Routing/Middleware/ThrottleRequests.php

Add return 99999999; after the line where it checks if the user is authenticated.

    /**
     * Resolve the number of attempts if the user is authenticated or not.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  int|string  $maxAttempts
     * @return int
     */
    protected function resolveMaxAttempts($request, $maxAttempts)
    {
        if (Str::contains($maxAttempts, '|')) {
            $maxAttempts = explode('|', $maxAttempts, 2)[$request->user() ? 1 : 0];
        }

        if (! is_numeric($maxAttempts) && $request->user()) {
            return 99999999;
            $maxAttempts = $request->user()->{$maxAttempts};
        }

        return (int) $maxAttempts;
    }

Setup the environment

1. Clone the project somewhere git clone https://git.nogafam.es/nogafam/ig-pixelfed-mirror.git
2. Create needed directories for the environment

cd ig-pixelfed-mirror/
mkdir cache db headers

3. Copy config.json.example to config.json and configure to your needs. Make sure you remove the comments from the file because Python doesn't like them.