Home

Welcome to the twdl wiki!

Examples

Download tweets from a text file

1. Create a file named tweets.txt with the text below:

https://twitter.com/Twitter/status/1067955850931855361
https://twitter.com/Twitter/status/1065406263612399617

2. Type the command into the terminal

twdl -l tweets.txt

Separate images by username

twdl -f "#username#/#original#" \
    https://twitter.com/Twitter/status/1067955850931855361 \
    https://twitter.com/firefox/status/1204042022509850625

Available variables: #tweet_id#, #original#, #username#

Embed metadata / data into downloaded media files

If you pass -e to twdl, it will use exiftool to write tweet and media URL to the file inside the IPTC metadata block (if possible).

twdl -e https://twitter.com/Twitter/status/1067955850931855361

If you pass -d, it will also write any text you want to add additionally.

twdl -d "this is an example" https://twitter.com/Twitter/status/1067955850931855361

Upload from clipboard (Windows only)

This script requires nircmd.

@echo off
nircmdc.exe clipboard saveimage %TEMP%\clipboard.png
imgops.exe search %TEMP%\clipboard.png