TiktokCrawler - TikTok Video Downloader CLI

Preview Tiktok Crawler

This is a command-line interface (CLI) tool for downloading TikTok videos and retrieving video information.

Features

• Download individual TikTok videos.
• Get detailed information about a TikTok video without downloading it.
• Download all videos from a specific TikTok user.
• Proxy support for all commands.

Installation

TiktokCrawler can be easily installed using pip or pipx. pipx is recommended for installing Python CLI applications as it installs them into isolated environments and makes them directly available in your shell.

1. Prerequisites:

   • Python 3.x
   • ffmpeg (required by yt-dlp for video processing). Make sure ffmpeg is installed and accessible in your system's PATH.

2. Install pipx (if you don't have it):

   pip install pipx
   pipx ensurepath
   

   Note: You might need to restart your terminal after running pipx ensurepath for the changes to take effect.

3. Install TiktokCrawler:

   Recommended (using pipx):

   pipx install tiktokcrawler
   

   Alternative (using pip):

   pip install tiktokcrawler
   

   Note: If you install with pip, you might need to manually add Python's user scripts directory to your system's PATH environment variable if the tiktok-crawler command is not found.

Usage

Once installed, you can run tiktok-crawler directly from your terminal.

Access Command Line Interface

tiktok-crawler --help

Download a single video

To download a TikTok video, use the download command followed by the video URL:

tiktok-crawler download "https://www.tiktok.com/@alalten/video/7401851105526828295?lang=id-ID&q=kaori%20waguri&t=1751721831935"

Get video information

To get information about a video without downloading it, use the info command:

tiktok-crawler info "https://www.tiktok.com/@alalten/video/7401851105526828295?lang=id-ID&q=kaori%20waguri&t=1751721831935"

Download all videos from a user

To download all publicly available videos from a TikTok user, use the user-videos command:

tiktok-crawler user-videos "https://www.tiktok.com/@alalten/video/"

Using a Proxy

You can specify a proxy for any command using the --proxy or -p option:

tiktok-crawler download "https://www.tiktok.com/@alalten/video/1234567890" --proxy "http://user:pass@host:port"
tiktok-crawler info "https://www.tiktok.com/@alalten/video/1234567890" -p "socks5://127.0.0.1:9050"
tiktok-crawler user-videos "https://www.tiktok.com/@alalten" --proxy "http://your.proxy.com:8080"

Project Structure

TiktokCrawler/
├── LICENSE
├── README.md
├── pyproject.toml
├── src/
│   └── TiktokCrawler/
│       ├── __init__.py
│       ├── cli.py
│       └── downloader.py
└── downloads/
    ├── 7401851105526828295.mp4
    └── 7439977461644840208.mp4

License

This project is licensed under the MIT License.

Contact

Thank You for passing by!! If you have any questions or feedback, please reach out to us at contact@akariwill.id.
or you can DM me on Discord wildanjr_ or Instagram akariwill. (just contact me on one of these account)

Contributing

Feel free to contribute to this project by submitting pull requests or opening issues in the repository.