Metadata-Version: 2.4
Name: tiksync
Version: 1.0.3
Summary: TikSync — TikTok Live SDK for Python. Real-time chat, gifts, likes & viewer events.
Home-page: https://tik-sync.com
Author: TikSync
Author-email: contact@tik-sync.com
License: MIT
Project-URL: Documentation, https://tik-sync.com/docs
Project-URL: Source, https://github.com/tiksync/tiksync-python
Keywords: tiktok,tiktok-live,websocket,api,sdk,gifts,chat
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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 :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.8
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

<p align="center">
  <img src="https://raw.githubusercontent.com/tiksync/.github/main/profile/logo-96.png" width="60" alt="TikSync" />
</p>

<h1 align="center">TikSync Python SDK</h1>

<p align="center">
  <strong>TikTok Live SDK for Python</strong> â€” Real-time chat, gifts, likes, follows & viewer events.<br>
  <a href="https://pypi.org/project/tiksync/"><img src="https://img.shields.io/pypi/v/tiksync.svg" alt="PyPI"></a>
  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a><br>
  <a href="https://tik-sync.com">Website</a> Â· <a href="https://tik-sync.com/docs">Documentation</a> Â· <a href="https://tik-sync.com/pricing">Pricing</a>
</p>

---

## Installation

```bash
pip install tiksync
```

## Quick Start

```python
from tiksync import TikSync

live = TikSync("username", api_key="your_api_key")

@live.on("chat")
def on_chat(data):
    print(f"[{data['uniqueId']}] {data['comment']}")

@live.on("gift")
def on_gift(data):
    print(f"{data['uniqueId']} sent {data['giftName']} x{data['repeatCount']}")

@live.on("follow")
def on_follow(data):
    print(f"{data['uniqueId']} followed!")

live.connect()
```

## Events

| Event | Description |
|-------|-------------|
| `connected` | Connected to stream |
| `chat` | Chat message received |
| `gift` | Gift received (with diamond count, streak info) |
| `like` | Likes received |
| `follow` | New follower |
| `share` | Stream shared |
| `member` | User joined the stream |
| `roomUser` | Viewer count update |
| `streamEnd` | Stream ended |
| `disconnected` | Disconnected |
| `error` | Connection error |

## Get Started

1. Sign up at [tik-sync.com](https://tik-sync.com)
2. Create a free API key in your dashboard
3. Install the SDK and start building

Free tier available. See [pricing](https://tik-sync.com/pricing) for details.

## License

MIT â€” Built by [TikSync](https://tik-sync.com)
