tystream 1.6.0

A Python library for Twitch & Youtube Stream Notification.

TYStream

TYStream is A Python library for Twitch & Youtube Stream Notification.

安裝套件

# Windows
pip install tystream

# Linux/MacOS
python3 -m pip install tystream

註冊API

Twitch

1. 前往 Twitch Developers 並登入你的帳號，接著點擊右上角的 Your Console。
2. 點選左側欄位的應用程式，再點選 註冊您的應用程式。
3. 為你的應用程式取一個自己的名字！其餘的照圖填入並按下建立即可。
4. 回到第三步驟的畫面後，點選剛建立好的應用程式最右側按鈕管理再點選最底下的 新密碼 底下便會多出用戶端ID和用戶端密碼兩個欄位的金鑰。
   
5. 很好，你已經完成了所有步驟！請將剛拿到的兩組金鑰記好，不要隨意外洩！

Youtube

1. 前往 Google Cloud Platform 並登入你的帳號。
2. 點選最上方欄位的 選取專案，再點選右上角的新增專案。
3. 按下建立後，依照圖片的搜尋方法找到 YouTube Data API v3

[!WARNING] 如果這步驟沒有正確啟用，那麼在使用套件的途中就會出現狀況。

4. 點選 啟用

5. 啟用完成後，點選左側欄位中的 憑證，再點選上方的 建立憑證，選擇 API 金鑰

6. 複製彈出視窗的API金鑰，並將此金鑰記下來，大功告成(ﾉ>ω<)ﾉ

如何使用

Twitch

client_id 和 client_secret 分別為你在 註冊API教學 (Twitch) 中拿到的 用戶端ID和用戶端密碼
streamer_name 為 twitch.tv/... 後的名稱

同步方法

from tystream import SyncTwitch
twitch = SyncTwitch("client_id", "client_secret")
stream = twitch.check_stream_live("streamer_name")
print(stream)

非同步方法

from tystream.async_api import AsyncTwitch
import asyncio

async def main():
    async with AsyncTwitch("client_id", "client_secret") as twitch:
        stream = await twitch.check_stream_live("streamer_name")
        print(stream)

asyncio.run(main())

Youtube

api_key 為你在 註冊API教學 (Youtube) 中拿到的 API金鑰
streamer_name 為實況主頻道網址 https://www.youtube.com/... 後的名稱 (有無@都亦可)

同步方法

from tystream import SyncYoutube
youtube = SyncYoutube("api_key")
stream = youtube.check_stream_live("streamer_name")
print(stream)

非同步方法

from tystream.async_api import AsyncYoutube
import asyncio

async def main():
    async with AsyncYoutube("api_key") as youtube:
        stream = await youtube.check_stream_live("streamer_name")
        print(stream)

asyncio.run(main())

使用 yt_dlp 方式

from tystream.async_api import AsyncYoutube # or SyncYoutube
import asyncio

async def main():
    async with AsyncYoutube("api_key") as youtube:
        stream = await youtube.check_stream_live("streamer_name", use_yt_dlp=True) # default is False
        print(stream)

asyncio.run(main())