README.md

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

Open Issues

Before open a issue, please read all the requirements, installation and usage section. If you have any questions, please open a issue answering the following questions:

• What is the problem? (Please describe and provide logs and/or screenshots)
• What version of Node.js and npm are you using?
• What operating system are you using?
• Are you using the latest version of the project?
• Did you follow all the requirements, installation and usage section?
• Did you try to run the project on another operating system/environment?

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.