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.1.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.1-py3-none-any.whl (19.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: tiktokcrawler-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 71339e3ebdef48c9d12f3e5001af6069cd4287281dbac0ba48608ee4d5159fb8
MD5 5df2467276e1779bf6b0c15e4e68bf8f
BLAKE2b-256 0b47b5ce0d45dd69a18ff1189b01e80c1c7bc46844346dd33580bb14f76dff80

See more details on using hashes here.

File details

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

File metadata

  • Download URL: tiktokcrawler-0.1.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e212fa33e0f466678eff91cc3874f7867a58e77a61b44a4bfa6fc74850b6ab11
MD5 53b771147b73817ceb6d4709a02423f1
BLAKE2b-256 45eca00af7d4d0e97b221205887303d944636a7771da321c0c1af11e5e7f2991

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