Repolode
Michele0303

Michele0303/tiktok-live-recorder

TikTok 라이브를 수동·자동·팔로잉 모드로 오디오와 영상까지 녹화하는 Python CLI 도구입니다.

스타
920
포크
237
열린 이슈
140
마지막 커밋
2개월 전

어떤 프로젝트인가요?

TikTok Live Recorder는 TikTok 라이브를 캡처해 로컬 파일로 저장하는 Python CLI 도구입니다. 오디오와 영상 모두 녹화하므로 라이브가 끝난 뒤 다시 보거나 보관할 수 있습니다.

-user, -url, -room_id 등의 플래그로 방송을 선택하고, -mode 플래그로 녹화 시작 방식을 지정합니다. manual 모드는 사용자가 라이브 중이면 바로 녹화하고, automatic 모드는 일정 간격으로 확인해 사용자가 라이브를 시작하면 녹화하며, followers 모드는 로그인한 사용자가 팔로우하는 모든 계정의 방송을 녹화합니다. 출력 디렉터리, 최대 녹화 시간, HTTP 프록시, 후처리 비트레이트를 설정하고 녹화가 끝난 파일을 Telegram에 업로드하는 옵션도 제공됩니다.

Windows, Linux, macOS와 Termux를 사용하는 Android에서 실행할 수 있으며, Docker 이미지로도 시작할 수 있습니다. Python 3.11 이상과 FFmpeg가 필요합니다.

핵심 기능

  • 01TikTok 라이브의 오디오와 영상을 모두 녹화합니다.
  • 02수동, 자동(간격별 확인), 팔로잉 녹화 모드를 지원합니다.
  • 03방송을 선택할 때 사용자명, 라이브 URL 또는 room ID를 지정할 수 있습니다.
  • 04출력 디렉터리, 최대 녹화 시간, HTTP 프록시, 출력 비트레이트를 설정할 수 있습니다.
  • 05녹화가 끝난 파일을 Telegram에 업로드하는 옵션을 제공합니다.
  • 06로컬 설치 외에 Docker 이미지로도 사용할 수 있습니다.

활용 사례

  • 팔로우하는 크리에이터의 TikTok 라이브를 보관해 나중에 시청합니다.
  • 콘텐츠 분석이나 연구를 위해 라이브 방송을 수집합니다.
  • 좋아하는 스트리머가 라이브를 시작할 때마다 방송을 자동으로 녹화합니다.
  • 서버나 컨테이너에서 무인으로 실행해 방송을 상시 녹화합니다.

빠른 시작

  1. 1

    필수 항목 설치: Git, Python 3.11 이상, FFmpeg

  2. 2

    저장소를 클론합니다

    git clone https://github.com/Michele0303/tiktok-live-recorder
  3. 3

    uv로 종속성을 설치합니다

    uv sync
  4. 4

    명령줄 옵션을 확인합니다

    uv run python src/main.py -h

사용 전 알아둘 점

  • 이 프로젝트는 TikTok과 제휴 관계가 없으며, 사용에 따른 책임은 사용자에게 있습니다.
  • 설치하려면 Python 3.11 이상, FFmpeg, uv가 필요하며 일부 기능에는 cookies.json 또는 Telegram 설정 파일이 필요합니다.

토픽

자주 묻는 질문

tiktok-live-recorder은(는) 무엇인가요?
TikTok 라이브를 수동·자동·팔로잉 모드로 오디오와 영상까지 녹화하는 Python CLI 도구입니다. TikTok Live Recorder는 TikTok 라이브를 캡처해 로컬 파일로 저장하는 Python CLI 도구입니다. 오디오와 영상 모두 녹화하므로 라이브가 끝난 뒤 다시 보거나 보관할 수 있습니다.
tiktok-live-recorder은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
tiktok-live-recorder은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
tiktok-live-recorder은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. tiktok-live-recorder의 마지막 커밋은 2026년 8월 12일입니다.
tiktok-live-recorder은(는) 어디에 사용할 수 있나요?
팔로우하는 크리에이터의 TikTok 라이브를 보관해 나중에 시청합니다. 콘텐츠 분석이나 연구를 위해 라이브 방송을 수집합니다. 좋아하는 스트리머가 라이브를 시작할 때마다 방송을 자동으로 녹화합니다. 서버나 컨테이너에서 무인으로 실행해 방송을 상시 녹화합니다.
tiktok-live-recorder는 어떻게 설치하나요?
필수 항목 설치: Git, Python 3.11 이상, FFmpeg 저장소를 클론합니다: git clone https://github.com/Michele0303/tiktok-live-recorder uv로 종속성을 설치합니다: uv sync 명령줄 옵션을 확인합니다: uv run python src/main.py -h
tiktok-live-recorder은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Michele0303/tiktok-live-recorder

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트