Skip to content

Latest commit

 

History

History
81 lines (57 loc) · 3.73 KB

README.md

File metadata and controls

81 lines (57 loc) · 3.73 KB

Tslazer

This is a program to download Twitter Spaces from the command line.

Also it's Lazer fast. It uses threading to ensure you always get the optimal download speed.

🚨 Important Update: July 2023 🚨

Due to recent changes in Twitter's API, you must supply cookies using the -c option. Twitter seems to have dissolved the usage of guest tokens, meaning that tslazer can no longer download spaces without authorization/credentials.

Usage

Supported URL Sources Example
Space ID/URL tslazer --space_id 1ZkJzbdvLgyJv --fileformat %St_%Ud
Master/Dynamic URL tslazer --dyn_url DYN_URL --filename space
With Cookies tslazer --space_id 1ZkJzbdvLgyJv --cookies cookies.txt --fileformat %St_%Ud

For more info on a Netscape HTTP Cookie File see cookie_spec

Requirements

This program requires ffmpeg to work. You can install it using sudo apt install ffmpeg.

Arguments

>python3 tslazer.py --help
usage: tslazer.py [-h] [--path PATH] [--cookies COOKIES] [--space_id SPACE_ID] [--withchat] [--fileformat FILEFORMAT] [--dyn_url DYN_URL] [--filename FILENAME] [--writeinfo] [--keepm3u8]

Download Twitter Spaces at lazer fast speeds!

options:
  -h, --help            show this help message and exit
  --path PATH, -p PATH  Path to download the space
  --cookies COOKIES, -c COOKIES
                        Path to your cookie.txt file

Downloading from a Space ID/URL:
  --space_id SPACE_ID, -s SPACE_ID
                        Twitter Space ID or URL
  --withchat, -wc       Export the Twitter Space's Chat
  --fileformat FILEFORMAT, -f FILEFORMAT
                        File Format Options:
                            %Ud Host Display Name     %Dy Year
                            %Un Host Username         %Dm Month
                            %Ui Host User ID          %Dt Time (Utc)
                            %St Space Title           %Dl Time (Local)
                            %Si Space ID


Downloading from a dynamic or master URL:
  --dyn_url DYN_URL, -d DYN_URL
                        Twitter Space Master URL or Dynamic Playlist URL
  --filename FILENAME, -fn FILENAME
                        Filename for the Twitter Space

Various Flags:
  --writeinfo, -wi      Write the Twitter Space information to a file
  --keepm3u8, -km       Keep the m3u8 playlist after downloading is complete
Argument Description
filename The filename for the space. There is no need to specify a file extension, as this is done automatically for you
dyn_url Master URL of a Twitter Space. Ends with dynamic_playlist.m3u8 or master_playlist.m3u8
space_id The Url or id of a Twitter Space.

Upcoming features

These are features that I will do my best to implement, but I can't offer any guarantees.

  • Discord Integration
  • Space Monitoring
  • Scheduled Spaces Support
  • Config Files
  • Monitor Multiple users at a time

Special Thanks

@notpeko

@Ryu1845 - Inspiration for the project and additional insight