loo-kuhs / tiktok-live-downloader

This is a console application built in TypeScript for downloading live shows from TikTok.

TikTok Live Stream Downloader

This is a refactored version of tiktok-live by Pauloo27.

Project Status

This project is currently in development. Before open a issue, please read all the requirements, installation and usage section.

Installation

Requirements

This project requires ffmpeg to be installed on your system. You can download it from here.

This project uses native fetch, so you need to have Node.js 18.0.0 or higher installed on your system. You can download it from here.

Install ffmpeg on Windows:

choco install ffmpeg-full
# or
scoop install ffmpeg
# or
winget install ffmpeg

Install ffmpeg on Linux:

sudo apt install ffmpeg

Install ffmpeg on MacOS:

brew install ffmpeg

Usage

Clone the repository:

git clone https://github.com/loo-kuhs/tiktok-live-downloader.git

Install dependencies:

npm install

Build the project:

npm run build

Run the project:

node build/app.js <username> --output <output> --format <format>
# or
node build/app.js <username> -o <output> -f <format>
# or
node build/app.js <username> -o <output>
# or
node build/app.js <username> -f <format>
# e.g.
node build/app.js mrbeast --output mydownloads --format mp4

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Thanks to Pauloo27 for the original project code base.