Metadata-Version: 2.1
Name: tksel
Version: 0.2.1
Summary: Scrapper for Minet csvs on tiktok
Project-URL: Documentation, https://github.com/Marceau-h/tksel#readme
Project-URL: Issues, https://github.com/Marceau-h/tksel/issues
Project-URL: Source, https://github.com/Marceau-h/tksel
Author-email: Marceau-h <106751184+Marceau-h@users.noreply.github.com>
Maintainer-email: Marceau-h <106751184+Marceau-h@users.noreply.github.com>
License-Expression: AGPL-3.0-or-later
License-File: LICENSE.txt
Keywords: TikTok,minet,tksel,video
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.7
Requires-Dist: pandas
Requires-Dist: requests
Requires-Dist: selenium
Requires-Dist: tqdm
Description-Content-Type: text/markdown

# tksel 

[![PyPI - Version](https://img.shields.io/pypi/v/tksel.svg)](https://pypi.org/project/tksel)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/tksel.svg)](https://pypi.org/project/tksel)

-----

**Table of Contents**

- [Installation](#installation)
- [License](#license)
- [Description](#description)
- [Usage](#usage)
  - [Example](#example)

## Installation

```console
pip install tksel
```

## License

`tksel` is distributed under the terms of the [AGPLv3 license](https://www.gnu.org/licenses/agpl-3.0.en.html).

## Description

`tksel` is a Python package that provides tool to recover videos from TikTok.
It is intended to be used on the csvs generated by [Minet](https://github.com/medialab/minet) but will work on any csv with the right columns:
- `id` (the id of the video), alias `video_id`
- `author_unique_id` (the id of the author), alias `author_id`

## Usage

```bash
tksel input.csv output_folder [--no-headless] [--no-verify]
```

- `input.csv` is the csv generated by minet or any csv with the right columns
- `output_folder` is the folder where the videos will be downloaded, it will be created if it doesn't exist, the input csv will also be copied there
- `--no-headless` is an optional argument to display the browser while it is downloading the videos
- `--no-verify` is an optional argument to disable the verification of the requests.get()

### Example

```bash
tksel temp.csv videos-collecte1 --no-headless --no-verify
```


