Instagram2Fedi Docs 📜

How to use

You can use Instagram2Fedi via docker or just like a python script

** Note: ** Credentials can be complicated. Running without Instagram credentials (user-name and user-password) appears to work for a short period of time but will, eventually, fail. Providing credentials will work unless Instagram issues a challenge. Recommend leaving user-name blank if running as a scheduled job (--scheduled) and providing them otherwise.

With Docker 🐋

Specify your variables in ./env.sh and then run ./run.sh

You can modify docker run arguments in ./run.sh

Just a python script 🐍

Run pip3 install -r requirements.txt and then run ./insta2fedi.

Specify your arguments. You should use --use-docker 0.

For example:

 ./insta2fedi --use-docker false --instagram-user <instagram username> --instance <instance domain> --token <OAuth token> --check-interval 10 --post-interval 10 --use-mastodon 4 --user-name <admin> --user-password <admin>
 # will check for new post each 10 seconds

Command line arguments 🖥

--use-mastodon - set not positive number (0, -1...) if your instance don't have max image count limit.

For example, default maximum photo count in mastodon is 4

--instance - Your instance url

--instagram-user - Your fetched instagram account user name.

--user-name - Your instagram user name.

--user-password - Your instagram password.

--token - Your OAuth token

--check-interval - Interval in seconds how often to check for new posts

--post-interval - Interval in seconds between posting new fetched posts.

If theres more than one new post, sets with which time interval should it post them

--fetch-count - How many new posts to select

--use-docker - If you're running it via docker container, set to 1 or True

--scheduled - If set, Instagram2Fedi runs once instead of sleeping for check-interval and running forever. This is intended for use as a cron job. No additional parameter is needed, just add --scheduled.

--verbose - If set, output all logs including secrets. No additional parameter is needed, just add --scheduled.

Default values ⚙

Default values are:

    --instance None
    --instagram-user None
    --token None
    --check-interval 3600
    --post-interval 3600
    --fetch-count  10
    --use-mastodon 4
    --use-docker True

2.4 KiB Raw Permalink Blame History