Introduction¶

파이썬 기반의 치지직(네이버 라이브 스트리밍 서비스)의 비공식 라이브러리 입니다.

An unofficial python library for Chzzk(Naver Live Streaming Service).

Feature

Chatting in live.
Search broadcaster, live, video.
Lookup a live of broadcaster.
Manage broadcast.

Installation¶

Python 3.10 or higher is required.

# Linux/MacOS
python3 -m pip install chzzkpy

# Windows
py -3 -m pip install chzzkpy

To install the development version.

$ git clone https://github.com/gunyu1019/chzzk_py
$ chzzk_py
$ python3 -m pip install -U .

Quick Example¶

This section is a simple example used in chzzpkpy. You can see more examples at Example Repository .

Searching broadcaster¶

import asyncio
import chzzkpy


async def main():
   client = chzzkpy.Client()
   result = await client.search_channel("건유1019")
   if len(result) == 0:
      print("검색 결과가 없습니다 :(")
      await client.close()
      return

   print(result[0].name)
   print(result[0].id)
   print(result[0].image)
   await client.close()

asyncio.run(main())

Chat Bot¶

from chzzkpy.chat import ChatClient, ChatMessage, DonationMessage

client = ChatClient("channel_id")

@client.event
async def on_chat(message: ChatMessage):
   if message.content == "!안녕":
      await client.send_chat("%s님, 안녕하세요!" % message.profile.nickname)

@client.event
async def on_donation(message: DonationMessage):
   await client.send_chat("%s님, %d원 후원 감사합니다." % (message.profile.nickname, message.extras.pay_amount))

client.run("NID_AUT", "NID_SES")

Collect Followers¶

import asyncio
import chzzkpy


async def main():
   client = chzzkpy.Client()

   # 채널 관리 기능을 이용하기 위해서는 네이버 사용자 인증이 필요합니다.
   # 웹브라우저의 쿠키 값에 있는 NID_AUT와 NID_SES 값으로 로그인을 대체할 수 있습니다.
   client.login("NID_AUT", "NID_SES")
   manage_client = client.manage("channel_id")

   followers = await manage_client.followers()
   if len(result) == 0:
      print("팔로워가 없습니다. :(")
      await client.close()
      return

   for user in result.data:
      print(f"{user.user.nickname}: {user.following.follow_date}부터 팔로우 중.")
   await client.close()

asyncio.run(main())