flifloo/BetterTwitFix
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Updated readme

Browse source
This commit is contained in:
Dylan 2022-05-14 00:24:58 +01:00
parent 819e2f1e31
commit 5dc0d42542
2 changed files with 6 additions and 60 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

BIN
example.gif
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 3.5 MiB

66
readme.md
View file

@ -1,5 +1,5 @@
# TwitFix
# vxTwitter
(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 also automatically embeds the first link in the text of non video tweets (API Only)
## How to use (discord side)
@ -9,46 +9,12 @@ just put the url to the server, and directly after, the full URL to the tweet yo
**I now have a copy of this running on a Linode server, you can use it via the following url**
```
https://fxtwitter.com/[twitter video url] or [last half of twitter url] (everything past twitter.com/)
https://vxtwitter.com/[twitter video url] or [last half of twitter url] (everything past twitter.com/)
```
You can also simply type out 'fx' directly before 'twitter.com' in any valid twitter video url, and that will convert it into a working TwitFix url, for example:
You can also simply type out 'vx' directly before 'twitter.com' in any valid twitter video url, and that will convert it into a working vxTwitter url, for example:
![example](example.gif)
**Note**: If you enjoy this service, please considering donating via [Ko-Fi](https://ko-fi.com/robin_universe) to help cover server costs
## Child Projects:
[TwitFix-Bot](https://github.com/robinuniverse/TwitFix-Bot) - A discord bot for automatically converting normal twitter links posted by users into twitfix links
[TwitFix-Extension](https://github.com/robinuniverse/TwitFix-Extension) - A browser extention that lets you right click twitter videos to copy a twitfix link to your clipboard
# Monthly Contributors
TwitFix is run for free, period, I have no plans to monetize it directly in any way ( no ads, no premium accounts with more features ) so I rely on donations to keep TwitFix running, and I have created the option to [donate on a monthly basis using my KoFi](https://ko-fi.com/robin_universe#tier16328580186740)
Here's a a list of the people who help to keep this project alive! ( current total monthly - $49!!! )
1. [$3] First Contributor and Twitter Funnyman **Chris Burwell** ( [@countchrisdo](https://twitter.com/countchrisdo) on Twitter )
2. [$9] Previously highest Contributor, Suspciously wealthy furry, and a very loving friend **Vectrobe** ( [@Vectrobe](https://twitter.com/Vectrobe) on Twitter )
3. [$10] New highest monthly contributor, **helloitscrash**!
4. [$6] A Mysterious and **Anonymous** contributor...
5. [$10] One of the highest contributors, **Ryan Vilbrandt**!
6. [$3] **Starcat13**, the one with the coolest sounding name
7. [$5] THE LIGHT THROUGH WHICH GOD SPEAKS TO THIS EARTH: **Statek**
8. [$3] **Impulse**, probably the source cheat
9. [$3] a STRONG contendor for coolest name, "**Lost in Art & Magic**"
**Note**: If you enjoy this service, please considering donating via [Ko-Fi](https://ko-fi.com/dylanpdx) to help cover server costs
## How to run (server side)
@ -58,7 +24,7 @@ I have included some files to give you a head start on setting this server up wi
### Config
TwitFix generates a config.json in its root directory the first time you run it, the options are:
vxTwitter 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
@ -90,24 +56,4 @@ This project is licensed under the **Do What The Fuck You Want Public License**
## Other stuff
Going to `https://fxtwitter.com/latest/` 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 `d.fxtwitter.com/<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 `https://fxtwitter.com/` to whatever your domain is
We check for t.co links in non video tweets, and if one is found, we direct the discord useragent to embed that link directly, this means that twitter links containing youtube / vimeo links will automatically embed those as if you had just directly linked to that content