BlueSkyImporter

Bring Your Content Home

Securely migrate your social media archives from Twitter, TikTok, Facebook, and Instagram to BlueSky. Keep your content, own your data, preserve your digital history.

Try Live Demo View on GitHub

The Great Migration

❌ The Old Way

  • Manual copy/paste of posts
  • Lost media and formatting
  • No timestamp preservation
  • Abandoned content on dead platforms
  • Corporate-owned data silos

✅ With BlueSkyImporter

  • Automated bulk import
  • Media files preserved
  • Timestamps maintained
  • One-click archive migration
  • You own your content

Platform Features

🌐

Multi-Platform Support

Import from Twitter/X, TikTok, Instagram, Facebook, Reddit (preview), and YouTube (preview). One tool handles all major platforms.

📦

Archive Processing

Handles ZIP and JSON archive formats. Automatic detection of platform format. Smart parsing of nested data structures.

👁️

Preview Before Import

See exactly what will be imported. Review posts, timestamps, and media. Selective import options for granular control.

🔐

Secure Processing

Uses BlueSky app passwords (not main password). No data stored on servers. Automatic session cleanup after processing.

🔄

Session Management

Track import progress. Resume interrupted imports. Session-based temporary storage with automatic cleanup.

📊

Admin Dashboard

Monitor all imports. View session logs. Track usage statistics. Secure token-based access control.

🐳

Docker Ready

One-command deployment. Docker Compose configuration included. Automatic container orchestration.

📤

Export Functionality

Export your BlueSky data anytime. No vendor lock-in. Full data portability for true ownership.

Technical Architecture

Backend

Python 3.8+ Flask atproto SDK Session Management

Data Processing

ZIP Archive Handling JSON Parsing Data Normalization Media Processing

Security

App Password Auth Token-Based Access Secure File Uploads Auto Cleanup

Deployment

Docker Docker Compose Nginx Systemd

Migration Workflow

1

Download Archive

Twitter: Settings → Your Account → Download Archive
TikTok: Settings → Privacy → Download Data
Instagram: Settings → Security → Download Data
Facebook: Settings → Your Information → Download

2

Upload & Preview

Upload your ZIP or JSON archive file. The system automatically detects the platform format and parses your posts. Review the preview to see exactly what will be imported.

3

Connect BlueSky

Enter your BlueSky username and app password (create one in Settings → App Passwords). Never use your main account password for security.

4

Import & Done

Click Import to migrate your content. Track progress in real-time. Session cleanup happens automatically. Your content is now on BlueSky!

Who Uses BlueSkyImporter?

📝 Content Creators

Preserve years of tweets, posts, and media without losing formatting or timestamps. Keep your creative work safe from platform closures.

🎓 Academics & Researchers

Archive social media data for research projects. Maintain complete datasets for longitudinal studies. Ensure data preservation.

🗣️ Activists & Journalists

Safeguard important social commentary and documentation. Protect against platform censorship or account deletion. Own your voice.

🏢 Organizations

Migrate institutional social media presence to decentralized platforms. Maintain brand continuity. Control your organization's data.

Deployment Options

🐳 Docker (Recommended)

docker-compose up -d

One-command deployment with automatic configuration.

🖥️ Local Development

pip install -r requirements.txt
python app.py

Quick setup for testing or development purposes.

☁️ Plesk/cPanel

Upload to web root, configure WSGI application. Deployment scripts included for major hosting platforms.

🔧 Systemd Service

Production-ready systemd service configuration. Automatic restart on failure. Logs managed via journald.

Ready to Migrate Your Content?

Try BlueSkyImporter today and take control of your social media data

Launch Live Demo View Documentation

Need custom migration tools? Contact ThreatTape