Skip to main content

A simple TikTok video downloader.

Project description

TiktokCrawler - TikTok Video Downloader CLI

Preview Tiktok Crawler

main 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

  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. Clone the repository (if you haven't already):

    git clone https://github.com/akariwill/TiktokCrawler.git 
    cd TiktokCrawler
    
  3. Install dependencies:

    pip install -r requirements.txt
    

Usage

This tool uses typer for its command-line interface. You can run commands directly from the app/cli.py module.

Access Command Line Interface

This tool uses typer for its command-line interface. You can run commands directly from the app/cli.py module.

python -m app.main"

Download a single video

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

python -m app.cli 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:

python -m app.cli 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:

python -m app.cli 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:

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

Project Structure

TiktokCrawler/
├── LICENSE
├── README.md
├── requirements.txt
├── app/
│   ├── __init__.py
│   ├── cli.py
│   ├── downloader.py
│   ├── main.py
│   └── __pycache__/
│       ├── __init__.cpython-313.pyc
│       ├── cli.cpython-313.pyc
│       ├── downloader.cpython-313.pyc
│       └── main.cpython-313.pyc
└── 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.


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

tiktokcrawler-0.1.2.tar.gz (19.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tiktokcrawler-0.1.2-py3-none-any.whl (19.6 kB view details)

Uploaded Python 3

File details

Details for the file tiktokcrawler-0.1.2.tar.gz.

File metadata

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

File hashes

Hashes for tiktokcrawler-0.1.2.tar.gz
Algorithm Hash digest
SHA256 2cd065af9bbee13ca30053b556de4927d8278a903652bbe46f46d67863ca8fd5
MD5 bf48dd3459c8374ae2ab154831dac9ec
BLAKE2b-256 4511e8aac7de8401dcc4a91c982071f19fd96579f498b9bbe8d83107aabb7f1e

See more details on using hashes here.

File details

Details for the file tiktokcrawler-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: tiktokcrawler-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 19.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for tiktokcrawler-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3a8a3c54aaf910d2d75fbfbc85f5383f40464fb0ab29203e5f1c7e334d0c2180
MD5 f8e4673788f26a5154adbec29e4409cd
BLAKE2b-256 52778152c516a0982f3e3807d464df5c05426618fc816ed492e9a994d837b7e8

See more details on using hashes here.

Supported by

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