Minimal fork of meant for embedding alongside Nitter
This repository has been archived on 2022-08-02. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Jill 552a5850ca wip flake 2022-08-02 11:07:06 +02:00
.github/ISSUE_TEMPLATE Updates and changes 2022-05-18 15:24:27 +01:00
static big fix for mp4 (I think) 2022-05-19 13:00:36 +01:00
templates nya 2022-05-26 23:55:55 +01:00
.gitignore wip flake 2022-08-02 11:07:06 +02:00
LICENSE.txt Too Init To Quit 2021-07-03 18:52:30 -05:00
flake.lock wip flake 2022-08-02 11:07:06 +02:00
flake.nix wip flake 2022-08-02 11:07:06 +02:00
links.json Added automatic link redirecting for links in non video tweets when using the API 2021-07-14 19:15:06 -05:00 modify readme 2022-08-02 04:50:54 +02:00
requirements.txt add missing dependencies to requirements.txt 2022-08-02 11:06:49 +02:00
twitfix.ini Update twitfix.ini 2022-05-23 01:11:43 +01:00 specify port with envvar PORT 2022-08-02 05:49:10 +02:00
twitfix.service Update twitfix.service 2022-05-18 18:44:19 +01:00 Updates and changes 2022-05-18 15:24:27 +01:00


(A fork of TwitFix) Basic flask server that serves fixed twitter video embeds to desktop discord by using either the Twitter API or Youtube-DL to grab tweet video information.

This repository adds support for Nix and restricts lots of features to make running it alongside Nitter a lot simpler. You'll still have to use a custom NGINX config, however

Regarding what happened to TwitFix:

How to use (discord side)[twitter video url] or [last half of twitter url])

How to run (server side)

If you want to run this on a non-Nix installation, follow the same instruction as upsteam

Otherwise, import the flake.nix file (or run nix flake run)


Twxtter generates a config.json in its root directory the first time you run it, the options are:

API - This will be where you put the credentials for your twitter API if you use this method

database - This is where you put the URL to your mongoDB database if you are using one

link_cache - (Options: db, json)

  • db: Caches all links to a mongoDB database. This should be used it you are using uWSGI and are not just running the script on its own as one worker
  • json: This saves cached links to a local links.json file

method - ( Options: youtube-dl, api, hybrid )

  • youtube-dl: the original method for grabbing twitter video links, this uses a guest token provided via youtube-dl and should work well for individual instances, but may not scale up to a very large amount of usage

  • api: this directly uses the twitter API to grab tweet info, limited to 900 calls per 15m

  • hybrid: This will start off by using the twitter API to grab tweet info, but if the rate limit is reached or the api fails for any other reason it will switch over to youtube-dl to avoid downtime

color - Accepts a hex formatted color code, can change the embed color

appname - Can change the app name easily wherever it's shown

repo - used to change the repo url that some links redirect to

url - used to tell the user where to look for the oembed endpoint, make sure to set this to your public facing url

This project is licensed under the Do What The Fuck You Want Public License

Other stuff

Going to will present a page that shows the all the latest tweets that were added to the database, use with caution as results may be nsfw! Current page created by @DorukSaga

Using the /dir/<video-url> endpoint will return a redirect to the direct MP4 link, this can be useful for downloading a video

Using the /dl/<video-url> or appending a .mp4 will make the server download the video and return a static, locally hosted copy

Using the subdomain<video-url> will redirect to a direct MP4 url hosted on Twitter

Using the /info/<video-url> endpoint will return a json that contains all video info that youtube-dl can grab about any given video

Using /other/<video-url> will attempt to run the twitter embed stuff on other websites videos - This is mostly experimental and doesn't really work for now

Using /api/latest/ will return a json with the latest tweet added to the database. Takes params ?tweets=INT&=pageINT to return multiple

Using /api/top/ will return a json with the most hit tweet in the database. Takes params ?tweets=INT&=pageINT to return multiple

Using /api/stats/ will return a json with some stats about TwitFix's activity (embeds, new cached links, API hits, downloads). Takes param ?=date"YYYY-MM-DD" to return a specific day, otherwise will return today's stats to far

Advanced embeds are provided via a /oembed.json? endpoint - This is manually pointing at my server in /templates/index.html and should be changed from to whatever your domain is


This is NOT actively monitored by anyone working on Twxtter. All tweets are publicly accessible.