Skip to main content

Record, concatenate and synchronize Twitch live streams

Project description

Python utils for Twitch PyPI version

pip3 install tdh-twitch-utils[all]

This module supports partial installation:

Package Scripts Dependencies
tdh-twitch-utils concat FFmpeg
tdh-twitch-utils[record] concat, record FFmpeg, streamlink
tdh-twitch-utils[offset] concat, offset FFmpeg, praat-parselmouth
tdh-twitch-utils[mute] concat, mute FFmpeg, tensorflow, spleeter
tdh-twitch-utils[all] all of the above all of the above

You can also provide a list of extras in a single command:

pip3 install tdh-twitch-utils[record,offset]

concat

This script uses MPEG-TS timestamps to concatenate multiple video segments into a single file without re-encoding. It is most useful for assembling partial stream recordings in case of interruption or error during stream download. Overlapping parts will be removed precisely with ffmpeg's concat demuxer.

Example

# download two overlapping segments (60 seconds each)
VOD="YOUR VOD ID"
streamlink -o 1.ts --hls-duration 60 "twitch.tv/videos/$VOD" best
streamlink -o 2.ts --hls-start-offset 30 --hls-duration 60 "twitch.tv/videos/$VOD" best

# concatenate two segments into one video
twitch_utils concat 1.ts 2.ts -o result.mp4

# create one segment
twitch_utils concat 1.ts 2.ts -o result.ts

# pipe concatenated MPEG-TS stream to other applications
twitch_utils concat 1.ts 2.ts -o - | ffmpeg -i - -c copy result.mp4

# preview result in mpv with seeking
twitch_utils concat 1.ts 2.ts -o - -f edl | mpv -
# or...
mpv $(twitch_utils concat 1.ts 2.ts -o - -f edl_uri)

record

This script can be used to record live streams without waiting for them to end. It starts to record live stream immediately, then downloads VOD and concatenates them into full stream recording.

Main features:

  • Start recording at any time - stream will be recorded from the beginning;
  • Monitor streamlink process for errors and skipped segments - and fix them;
  • Resume recording after restart of the script - it is possible as long as the stream is still online and already downloaded parts are accessible;
  • Skip ads even without paid subscription - ad segments will be ignored by streamlink and missing original segments will be downloaded from VOD;

Algorithm:

  1. Check if channel is live and VOD for current stream already exists;
  2. Get live VOD ID from Twitch API;
  3. Start downloading live stream into file VOD.0.ts;
  4. Wait 1 minute and start downloading VOD into file VOD.1.ts;
  5. Wait for VOD download to finish;
  6. Check the possibility of concatenation and download missing parts of the timeline;
  7. Wait for stream to finish;
  8. Restart stream recording in case of errors or skipped segments, wait 1 minute and go to step 6;
  9. Concatenate all parts via concat script (see above).

Example

# Record live stream of channel 'blackufa' using 2 threads
twitch_utils record -j 2 blackufa

offset

This script performs cross-correlation of two audio files to find offset between them. First argument is cropped and used as template. Second argument can have any duration -- it will be divided into separate chunks to reduce memory usage (otherwise it wouldn't be possible to use exceptionally big files). Both arguments can be videos or audio files -- audio track will be extracted and converted. You can even use HTTP links if ffprobe is able to correctly determine second argument's duration.

Example

# Cut small segment from big video file (offset: 123 seconds)
ffmpeg -ss 123 -i YOUR_FILE.mp4 -t 60 -c copy template.mp4

# Find offset of template.mp4 within YOUR_FILE.mp4
twitch_utils offset template.mp4 YOUR_FILE.mp4
# ... returns 122.99997732426303

# Same command, but result will be rounded to nearest integer
twitch_utils offset template.mp4 YOUR_FILE.mp4 --round
# ... returns 123

mute

This script attempts to separate streamer's voice from background music by using Spleeter. Only specified time ranges are affected. Output contains the same video, but without music in these parts.

The main purpose of this script is to remove automated Content-ID claims from the video on YouTube without muting the whole section.

The result is similar to "Mute song only (beta)" in YouTube Studio, but this script is much faster and can handle multiple time ranges at once.

Note: Prebuilt binaries of Tensorflow require CPUs with AVX support.

Example

# Remove music from 5:00 to 8:00 and from 1:00:00 to 1:05:00
twitch_utils mute input.mp4 5:00~8:00 1:00:00~1:05:00 -o output.mp4

Thanks

  • TwitchRecover for finding a way to download unlisted/broken VODs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tdh_twitch_utils-1.8.0.tar.gz (30.6 kB view details)

Uploaded Source

Built Distribution

tdh_twitch_utils-1.8.0-py3-none-any.whl (34.3 kB view details)

Uploaded Python 3

File details

Details for the file tdh_twitch_utils-1.8.0.tar.gz.

File metadata

  • Download URL: tdh_twitch_utils-1.8.0.tar.gz
  • Upload date:
  • Size: 30.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for tdh_twitch_utils-1.8.0.tar.gz
Algorithm Hash digest
SHA256 367f8e3fc4efe54c1383c269d9312f63dbe4f89ec8c5821efd9f06094111e532
MD5 4cea6b6af853229d8de65e6f0f9805d8
BLAKE2b-256 38c3a3c3f8e58ee349452ab3c6c2eb9ffdc5aa46a0c929b07c7f458f94843329

See more details on using hashes here.

File details

Details for the file tdh_twitch_utils-1.8.0-py3-none-any.whl.

File metadata

File hashes

Hashes for tdh_twitch_utils-1.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c7b4c21ec7ba551c45e56b1dd3d8e4d9e7ef35bad066255a897c0b62cbd4235c
MD5 39e379b1601e5b35325e3d8f2336b8c9
BLAKE2b-256 e09ca6efff22c42a7fd2872df209adaa55c051dd2b72731414f7551b9fd1d3b6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page