Import Instagram archive to a Bluesky account
9
fork

Configure Feed

Select the types of activity you want to include in your feed.

Update documentation for split functionality.

+10 -6
+10 -6
README.md
··· 54 54 ARCHIVE_FOLDER=c:/download/instagram-username-2025-XX-XX-hash 55 55 56 56 # Optional settings 57 - SIMULATE=1 # Set to 1 to simulate import without posting 58 - TEST_VIDEO_MODE=0 # Set to 1 to test video imports 59 - TEST_IMAGE_MODE=0 # Set to 1 to test image imports 60 - TEST_IMAGES_MODE=0 # Set to 1 to test post with many images. (5 yet only 4 will be allowed due to limit.) 61 - LOG_LEVEL=debug # Set logging verbosity (debug, info, warn, error) 57 + SIMULATE=1 # Set to 1 to simulate import without posting 58 + TEST_VIDEO_MODE=0 # Set to 1 to test video imports 59 + TEST_IMAGE_MODE=0 # Set to 1 to test image imports 60 + TEST_IMAGES_MODE=1 # 5 images in a post (all 4 should upload, plus a second post with 1) 61 + TEST_MIXED_MEDIA_MODE=0 # many images and videos, single post split into 5, with a total of 10 media uploaded. 62 62 MIN_DATE=2020-01-01 # Only import posts after this date 63 63 MAX_DATE=2025-01-01 # Only import posts before this date 64 + LOG_LEVEL=debug # Set logging verbosity (debug, info, warn, error) 64 65 ``` 65 66 66 67 ## Running the Import ··· 72 73 73 74 ### Test Modes 74 75 75 - The project includes two test modes to verify imports: 76 + The project includes four test modes to verify imports: 76 77 77 78 - `TEST_VIDEO_MODE`: Tests video import functionality 78 79 - `TEST_IMAGE_MODE`: Tests image import functionality 80 + - `TEST_IMAGES_MODE`: Tests max image per post split functionality. 81 + - `TEST_MIXED_MEDIA_MODE`: Tests posts with video and image formats splitting content to match Bluesky's limitations. 79 82 80 83 Enable these by setting the corresponding environment variable to 1. Note: You cannot enable both modes simultaneously. 81 84 ··· 92 95 ## Limitations 93 96 94 97 - Maximum 4 images per post (Bluesky platform limit) 98 + - Splits posts adding a postfix `(Part 1/4)` ensuring no data loss. 95 99 - Maximum video size of 100MB 96 100 - Rate limiting enforced between posts 97 101 - Stories, and likes can not be imported.