pxTwitter (Twittpr)

A TwitFix-like service that does more with better privacy in mind. Written in TypeScript for Cloudflare Workers!

Embed videos, polls, and more on Discord, Telegram, and others!

On Discord, send a Twitter link and type s/e/p to make twittpr.com.

Otherwise, just add px before twitter to make pxtwitter.com

✔️ Embed Videos (Including Twitter videos and compatible external providers, such as YouTube)

✔️ Embed Poll results

✔️ Embed Quote Tweets (Including their media, if it doesn't conflict with the linked tweet)

✔️ Replace embedded t.co shortener with original links

✔️ Creates media/profile picture color-matching theme-color (looks great on Discord!)

✔️ Better privacy: We don't save tweets or their media (Outside of temporary Cloudflare caching for speed)

---

Advanced features

Direct media links

Want to link directly to a Tweet's media without the embed? You can do that with pxTwitter.

There's a few supported ways to do this:

• Add d. or dl. before the domain (so, d.twittpr.com or dl.pxtwitter.com)
• Add .mp4 to the end of videos or .jpg to the end of images, after the tweet ID
• Add /dl or /dir between the domain and the username

Examples from above:

• https://d.twittpr.com/dangeredwolf/status/1548119328498728960
• https://pxtwitter.com/dangeredwolf/status/1548117889437208581.jpg
• https://pxtwitter.com/dl/dangeredwolf/status/1548117889437208581

Tweets with multiple images are supported, so you can do something like this and it will pick the correct one:

https://d.twittpr.com/dangeredwolf/status/1547514042146865153/photo/3

Otherwise, it will default to the first image.

---

Why use pxTwitter?

In many ways, pxTwitter has richer embeds and does more. Here's a table comparing some of pxTwitter's features compared to Twitter default embeds as well as other embedding services

	pxTwitter	Twitter default	vxTwitter (BetterTwitFix)	Twxtter (sixFix)
Embed Tweets / Images	✔️	✔️	✔️	✔️
Embed profile pictures on text Tweets	✔️	❌	✔️	✔️
Embed Twitter Videos	✔️	❌¹	✔️	✔️
Embed External Videos (YouTube, etc.)	✔️	❌	❌⁴	❌
Embed Poll results	✔️	❌	❌	❌
Embed Quote Tweets	✔️	❌	☑️ Without Media	☑️ Without Media
Embed Multiple Images	❌	➖ Discord Only³	With c.vxtwitter.com	❌
Publicly accessible embed index	❌²	N/A	❌²	✔️
Replace t.co with original links	✔️	❌	❌	❌
Media-based embed colors on Discord	✔️	❌	❌	❌
Redirect to media file (wihout embed)	✔️	❌	❌	✔️
Strip Twitter tracking info on redirect	✔️	❌	✔️	✔️
Show retweet, like, reply counts	✔️	➖ Likes in Discord Only³	☑️ No replies	☑️ No replies
Discord sed replace (s/) friendly	twittpr.com	❌	❌	✔️

¹ Discord will attempt to embed Twitter's video player, but it is unreliable

² Neither pxTwitter or vxTwitter have a public embed ledger, for privacy reasons. vxTwitter still stores all responses in a database / JSON file controlled by the owner. pxTwitter by contrast relies on Cloudflare caching of responses: there is no link store accessible to the owner.

³ Discord uses a custom embed container for Twitter.com to enable multi-image, which is unfortunately not available to other websites.

⁴ On GitHub, BetterTwitFix (vxTwitter) claims to support this feature, however in my testing as of mid-July 2022, this does not seem to work.

---

Why pxTwitter is nicer to develop for and deploy

TwitFix and its derivatives have quite a few dependencies you need to rely on. You need to set up a server somewhere, install Python, all its dependencies, then either set up youtube-dl (more resource intensive) or beg Twitter for API access, and optionally set up a database, otherwise it uses the file system to cache.

pxTwitter was written from the start as a lightweight, TypeScript-based Cloudflare Worker. Cloudflare Workers are completely free for up to 100,000 requests per day, per account. Cloudflare Workers are fast to set up and your script is distributed in their datacenters around the world for lower latency.

pxTwitter does not need a database nor a Twitter API key: It takes a similar approach to youtube-dl where it pretends to be a logged-out Twitter web user, fetching a guest token and making API requests from there. As far as I can tell, this basically means we have "unlimited" read-only access to Twitter's API, including things they don't expose in their public API, useful for polls and other features.

Deploy pxTwitter yourself

Clone the repo, install Node.js and run npm install in the repo directory. Copy wrangler.example.toml to wrangler.toml and add your Cloudflare account ID, and change the name of your worker if you need to. Also copy .env.example to .env and change HOST_URL, DIRECT_MEDIA_DOMAINS to your desired domain and whatever else you need to do. Authenticate with Cloudflare with npx wrangler login, then do npx wrangler publish (or npm run publish).

If you have more questions about setting up Cloudflare Workers, check out their Getting Started guide.

Once you're set up with your worker on *.workers.dev, add your worker to your custom domain.

---

Licensed under the permissive MIT license. Feel free to send a pull request!

Things to tackle in the future

• Combining multiple images together (would be outside CF Worker)
• Feature: Translating Tweets within pxTwitter

Bugs or issues?

Feel free to open an issue, or ping me on Twitter and I'll see what I can do.