Metadata-Version: 2.1
Name: mytiktok
Version: 0.0.4
Summary: A Simple Python Package for Scarping and Downloading Tiktok Videos
Author-email: Dragoneyes <yolo89381@gmail.com>
Project-URL: Homepage, https://github.com/geovanigaldemsugar/Mytiktok
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: backports.tarfile==1.1.1
Requires-Dist: blinker==1.8.1
Requires-Dist: Brotli==1.1.0
Requires-Dist: certifi==2024.2.2
Requires-Dist: cffi==1.16.0
Requires-Dist: charset-normalizer==3.3.2
Requires-Dist: cryptography==42.0.5
Requires-Dist: docutils==0.21.2
Requires-Dist: exceptiongroup==1.2.1
Requires-Dist: fake-useragent==1.5.1
Requires-Dist: h11==0.14.0
Requires-Dist: h2==4.1.0
Requires-Dist: hpack==4.0.0
Requires-Dist: hyperframe==6.0.1
Requires-Dist: idna==3.7
Requires-Dist: importlib_metadata==7.1.0
Requires-Dist: jaraco.classes==3.4.0
Requires-Dist: jaraco.context==5.3.0
Requires-Dist: jaraco.functools==4.0.1
Requires-Dist: jeepney==0.8.0
Requires-Dist: kaitaistruct==0.10
Requires-Dist: keyring==25.2.0
Requires-Dist: markdown-it-py==3.0.0
Requires-Dist: mdurl==0.1.2
Requires-Dist: more-itertools==10.2.0
Requires-Dist: nh3==0.2.17
Requires-Dist: outcome==1.3.0.post0
Requires-Dist: pathvalidate==3.2.0
Requires-Dist: pkginfo==1.10.0
Requires-Dist: pyasn1==0.6.0
Requires-Dist: pycparser==2.22
Requires-Dist: Pygments==2.17.2
Requires-Dist: pyOpenSSL==24.1.0
Requires-Dist: pyparsing==3.1.2
Requires-Dist: PySocks==1.7.1
Requires-Dist: python-dotenv==1.0.1
Requires-Dist: readme_renderer==43.0
Requires-Dist: requests==2.31.0
Requires-Dist: requests-toolbelt==1.0.0
Requires-Dist: rfc3986==2.0.0
Requires-Dist: rich==13.7.1
Requires-Dist: SecretStorage==3.3.3
Requires-Dist: selenium==4.20.0
Requires-Dist: sniffio==1.3.1
Requires-Dist: sortedcontainers==2.4.0
Requires-Dist: tenacity==8.2.3
Requires-Dist: trio==0.25.0
Requires-Dist: trio-websocket==0.11.1
Requires-Dist: typing_extensions==4.11.0
Requires-Dist: undetected-chromedriver==3.5.5
Requires-Dist: urllib3==2.2.1
Requires-Dist: websockets==12.0
Requires-Dist: wsproto==1.2.0
Requires-Dist: zipp==3.18.1
Requires-Dist: zstandard==0.22.0

# MyTIkTok
### A Simple Python Package for Scarping and Downloading Tiktok Videos


## Installation

### Linux/Unix 
-  **`pip3 install mytiktok`**

### Windows
-  **`pip install mytiktok`**


## Example Usages
### Search for tiktok videos

```python 
from mytiktok import Tiktok


email = 'your_tiktok_email@gmail.com'
password = 'your_tiktok_password'
search_term = '#JesusSaves #prayer'

#the package needs an account login details to create cookie sessions 
tiktok  = Tiktok(email=email, password=password)

#returns a videos object
videos  = tiktok.search(search_term=search_term, amnt=14)
print(videos.info_list)

``` 
### Get Videos of an Accounts Video

```python 
from mytiktok import Tiktok


email = 'your_tiktok_email@gmail.com'
password = 'your_tiktok_password'

accounts  = [
'@calebbpartain',
'@dailychristmotives',
'@inspiringfaith1',
'@spreadthewordbro_',

]

#the package needs an account login details to create cookie sessions 
tiktok  = Tiktok(email=email, password=password)

#returns a videos object
videos  = tiktok.accounts(accounts=accounts, amnt=14)
print(video.info_dict)

```
### Downloading Videos

#### Downloads videos via Search  or Accounts

```python         
videos.download(folder_name = 'Example_Folder') 
```

#### Download via Video

```python
from mytiktok.video import Video

url = 'https://www.tiktok.com/@calebbpartain/video/7363384781024906538'

video  = Video(url = url)
video.download(file_name='test.mp4')

```
#### Download via Videos Class
```python
from mytiktok.videos import Videos


urls  = [
'https://www.tiktok.com/@calebbpartain/video/72961sadsada4967404662062',
'https://www.tiktok.com/@calebbpartain/video/7314359034906234155',
'https://www.tiktok.com/@calebbpartain/video/7207942650564119854',
'https://www.tiktok.com/@calebbpartain/video/7363384781024906538',
]

videos  = Videos(urls = urls)
videos.download(folder_name='Test_videos')

```

## Limitations
- **Uses Chrome Instances**
- **Login attempts Frequently Fail**
- **Download atempts can fail from time to time**

#### If your planning to download in bulk ensure to save urls and use `Videos` class instead

> [!NOTE]
> If using this package headlessy, is important to your needs try running your script in a Docker

> [!IMPORTANT]
> Proxing has not been implemented so there is possiblity of snaptik.app blocking you and or slowing down connection but just dont download excessively, keep the rates low and you should be fine
