A tool for retrieving deleted X(Twitter) tweets and their media content from Wayback Machine archives. This tool helps you recover tweets that have been deleted but were previously archived by the Wayback Machine.
- Retrieve deleted tweets from Wayback Machine archives
- Download media content (images) from archived tweets
- Multi-threaded downloads for improved performance
- Robust error handling with automatic retries
- Date-based hierarchical data organization
- Optimized execution using Bun runtime
- Bun (v1.0.0 or later)
# Clone the repository
git clone https://github.com/zozonteq/backxive.git
cd backxive
# Install dependencies
bun installGenerate a list of archived tweets to download:
bun run src/cli.ts list <username>Download deleted tweets from the Wayback Machine:
bun run src/cli.ts download <list_file>Download images from archived tweets:
bun run src/cli.ts image <username>.
├── attaches/ # Downloaded images from archived tweets
├── tweets/ # Downloaded archived tweets
│ └── YYYY/ # Year
│ └── MM/ # Month
│ └── DD/ # Day
├── src/
│ ├── cli.ts # Command-line interface
│ ├── modules/ # Feature modules
│ └── core/ # Core functionality
└── .env # Configuration file
The tool includes robust error handling with the following features:
- Automatic retries for failed downloads
- Rate limiting protection for Wayback Machine API
- Skip existing files
- Detailed error reporting
- Handling of 404 errors for deleted content
- This tool can only retrieve tweets that were previously archived by the Wayback Machine
- Not all deleted tweets may be available in the archive
- The success rate depends on the Wayback Machine's archive coverage
MIT License