twspace-dl 2021.11.13.1

The only tool to record Twitter spaces (yet)

Twspace-dl

A python script to download twitter spaces.

Requirements

ffmpeg

Install

From source

git clone --depth 1 https://github.com/Ryu1845/twspace-dl
cd twspace-dl
pip install .

From PyPI

pip install twspace-dl

Usage

twspace_dl -i space_url

Features

Here's the output of the help option

usage: twspace_dl [-h] [-t THREADS] [-v] [-s] [-k] [-i SPACE_URL] [-U USER_URL] [-d DYN_URL] [-f URL]
                  [-o FORMAT_STR] [-m] [-p] [-u]

Script designed to help download twitter spaces

optional arguments:
  -h, --help            show this help message and exit
  -t THREADS, --threads THREADS
                        number of threads to run the script with(default with max)
  -v, --verbose
  -s, --skip-download
  -k, --keep-files

input:
  -i SPACE_URL, --input-url SPACE_URL
  -U USER_URL, --user-url USER_URL
  -d DYN_URL, --from-dynamic-url DYN_URL
                        use the master url for the processes(useful for ended spaces)
  -f URL, --from-master-url URL
                        use the master url for the processes(useful for ended spaces)

output:
  -o FORMAT_STR, --output FORMAT_STR
  -m, --write-metadata  write the full metadata json to a file
  -p, --write-playlist  write the m3u8 used to download the stream(e.g. if you want to use another downloader)
  -u, --url             display the master url

Format

You can use the following identifiers for the formatting

%(title)s
%(id)s
%(start_date)s
%(creator_name)s
%(creator_screen_name)s
%(url)s

Example: [%(creator_screen_name)s]-%(title)s|%(start_date)s

Service

There's an example service file there You'll have to modify different stuff depending on how you installed or not the script.

I'd be very grateful if someone made a PR with a bash script automating those ;)

Cloned Repository

In that case, you'll have to modify the WorkingDirectory to where you cloned the repo.

Pip

1. Change WorkingDirectory to where you want the spaces to be downloaded.
2. Find where your executable is by running which twspace_dl in your terminal.
3. Change the /usr/bin/python twspace_dl part to the path of your executable.

Now to install the service, you can either install it as a user service(recommended if on your personal desktop), or as a normal service.

User

1. Copy the file you modified earlier to ~/.config/systemd/user(create the systemd directory if it doesn't exist).
2. run

systemctl --user daemon-reload
systemctl --user start twspace-dl@USER_ID.service

USER_ID is the part after https://twitter.com/ in the url of a twitter profile (i.e https://twitter.com/USER_ID)

To keep it working after restarts run:

systemctl --user enable twspace-dl@USER_ID.service

System

1. Copy the file you modified earlier to /etc/systemd/system.
2. run

sudo systemctl daemon-reload
sudo systemctl start twspace-dl@USER_ID.service

USER_ID is the part after https://twitter.com/ in the url of a twitter profile (i.e https://twitter.com/USER_ID)

To keep it working after restarts run:

sudo systemctl enable twspace-dl@USER_ID.service