Issues - Scoofszlo/tk3u8 GitHub Wiki

This page covers the issues that may arise within the usage of the program, explains what causes themn, and what should you do.

WAFChallengeError occasionally pops up

Occasionally, when you download a stream from a user, you may encounter WAFChallengeError raised by the program. There is no solid evidence for this one, but one possible reason is that it is just the site's prevention of handling bot requests to their server.

Based on testing so far, here are some possible temporary fixes.:

I have discovered a method to potentially minimize this error to happen. This is planned for release somewhere in v0.3.0 or v0.4.0, so stay tuned!

StreamLinkNotFoundError occurs

This one is likely to happen for those who live in the US region (and potentially nearby countries as well), or if you set tt_target_idc to useast2a in the config file. To explain tt_target_idc in simple terms, it is kinda like the server location that your account connects to.

As I have observed, no stream links appear for any quality (original, uhd, hd, sd, etc.), causing this exception to occur. Below is an example from what gets scraped from source (with actual data removed).

{
    "common": { "..." },
    "data": {
        "sd": {
            "main": {
                "flv": "https://pull-q5-sg01.fcdn.eu.tiktokcdn.com/stage/stream-0000000000000000000_sd.flv?expire=0000000000&sign=00000000000000000000000000000000",
                "hls": "",  // There should be an HLS link here, but the source only provides an empty string.
                "other_keys": "..."
            }
        },
        "ld": {
            "main": {
                "flv": "https://pull-q5-sg01.fcdn.eu.tiktokcdn.com/stage/stream-0000000000000000000_sd.flv?expire=0000000000&sign=00000000000000000000000000000000",
                "hls": "",  // There should be an HLS link here, but the source only provides an empty string.
                "other_keys": "..."
            }
        },
        "other_qualities": { "..." }
    }
}

To fix this issue, use VPN and/or avoid setting tt_target_idc in the config file. If you are using a VPN, the server that you should connect could be anywhere, as long as it is not the US servers or one nearby.

Alternatively, if one prefers not using VPN, you can set the tt_target_idc to any valid values such as alisg or useast1a. These are the valid values that I have tested and have work so far.

Both of these methods will fix this issue most likely, but you may encounter WAFChallengeError more often. Nevertheless, the guide for setting up tt_target_idc in your config file is available here.

StreamDataNotFoundError occurs

The cause of this exception is not yet confirmed due to limited testing, but I suspect that this is due to live restrictions. To fix this, you have to supply sessionid_ss in your config file. To set this up, refer to this guide.

See Also