Twayback: Downloading deleted Tweets from the Wayback Machine, made easy
Finding and downloading deleted Tweets takes a lot of time. Thankfully, with this tool, it becomes a piece of cake!
Twayback is a portmanteau of Twitter and the Wayback Machine. Enter your desired Twitter username, and let Twayback do the rest!
Requirements
- Python 3
- waybackpack
- Install:
pip install waybackpack
orpip3 install waybackpack
- Link to repo
- Install:
Features
- Can download some or all of a user's archived deleted Tweets.
- Allows custom time range to narrow search for deleted Tweets archived between two dates.
- Differentiates between accounts that are active, suspended, or don't/no longer exist.
- Lets you know if a target handle's archived Tweets have been excluded from the Wayback Machine.
Usage
twayback -u USERNAME [OPTIONS]
Example: twayback -u jack
-u, --username Specify target user's Twitter handle
-from, --fromdate Narrow search for deleted Tweets *archived* on and after this date
(can be combined with -to)
(format YYMMDD)
-to, --todate Narrow search for deleted Tweets *archived* on and before this date
(can be combined with -from)
(format YYMMDD)
Installation
For Windows only
- Download the latest EXE file.
- Launch Command Prompt in the EXE file's directory.
- Run the command
twayback -u USERNAME
(ReplaceUSERNAME
with your target handle).
For Windows, Linux, and macOS
- Download the latest ZIP file.
- Extract ZIP file to a directory of your choice.
- Open terminal in that directory.
- Run the command
pip install -r requirements.txt
. - Run the command
twayback -u USERNAME
(ReplaceUSERNAME
with your target handle).
For more information, check out the Usage section above.
Things to keep in mind
- Quality of the HTML files depends on how the Wayback Machine saved them. Some are better than others.
- This tool is best for text. You might have some luck with photos. You cannot download videos.
- By definition, if an account is suspended or no longer exists, all their Tweets would be considered deleted.
- Custom date range is not about when Tweets were made, but rather when they were archived. For example, a Tweet from 2011 may have been archived today.
Future plans
- GUI. This is a biggie. I don't know shit about Python, let alone GUI. But I'm hoping I can design one using Tkinter Designer. But I don't know how I can link actions to buttons and shit like that, that stuff is super foreign to me, so any help is appreciated, it would mean so much.
Plenty of thanks to jsvine for his amazing work on waybackpack. Without it, this tool cannot work nearly as well.
I hope you enjoy my little script. Please use it for good. Whatever you are, be a good one.