anYuJia/better-douyin

打造更好用的douyin,支持作者级下载、播放、点赞收藏、私信、通知、mcp服务接入ai控制,内置ai可以在私信与好友ai聊天。douyin download

better‑douyin – Douyin(TikTok)용 경량 Rust/Tauri 데스크톱 클라이언트

설명

  • Rust + Tauri로 런타임을, React + Vite + TypeScript로 UI를 구축한 데스크톱 애플리케이션(Windows/macOS/Linux).
  • 피드 탐색, 사용자 검색, 동영상 시청, 콘텐츠 다운로드, 다중 계정 관리, AI 보조 기능(OpenAI 호환 서비스를 통한 자동 댓글·답글 생성 등)을 갖춘 완전한 Douyin 환경을 제공합니다.
  • 공개 리포지토리에는 "오픈 셸"(UI, 모의 브리지, 데모 데이터를 반환하는 모의 Node.js 백엔드)만 포함되어 있습니다. 실제 기능 백엔드(Douyin 서버와 통신하고 쿠키·서명 등을 처리)는 컴파일된 바이너리로 GitHub Releases에서 배포됩니다.

존재 이유

  • 공식 모바일/웹 클라이언트보다 가볍고 안정적인 데스크톱 환경을 제공하고, 네이티브 재생, 오프라인 다운로드 관리, 크로스 플랫폼 배포를 실현하기 위함.
  • 핵심 로직은 클로즈드(악용 방지)로 유지하면서 커뮤니티가 UI/UX 개선, 테마 조정, 접근성 수정 등 프론트엔드 개선에 기여할 수 있도록 하기 위함.

주요 기능(전체 바이너리)

  • 콘텐츠 탐색 – 사용자 이름/UID 검색, 공유 링크 파싱, 사용자 프로필, 피드, 좋아요·즐겨찾기·컬렉션 동영상 보기.
  • 다운로드 관리자 – 큐, 일시 중지/재개, 일괄 다운로드, 사용자 지정 이름 템플릿, 화질 선택, 로컬 라이브러리 보기.
  • 내장 플레이어 – 속도, 볼륨, 해상도 전환, 자동 재생, 플레이어 내 작업(좋아요, 댓글, 공유).
  • 소셜 기능 – 친구 목록, 비공개 메시지, 알림, AI 생성 댓글/DM.
  • 자동화 – 피드, 비공개 메시지, 크리에이터 업데이트 모니터링. 사용자 정의 규칙에 따라 자동 좋아요, 자동 댓글, 자동 팔로우 등을 트리거합니다.
  • 다중 계정 지원 – 쿠키와 계정 데이터를 로컬에 저장하고 안전하게 계정을 전환합니다.
  • AI 통합 – OpenAI 호환 서비스를 플러그인하여 댓글, 답글, 콘텐츠 분석용 텍스트를 생성합니다.
  • 로컬 HTTP MCP 서비스 – 외부 AI 도구(예: Claude, Codex)가 사용자의 명시적 동의 하에 앱 상태를 조회하거나 명령을 실행할 수 있게 합니다.

시도 방법

  1. Releases 페이지에서 컴파일된 릴리스를 다운로드합니다(리포지토리의 README는 일반 사용자에게 이 방법을 강력히 권장). 릴리스에는 검증용 체크섬 파일이 포함됩니다.
  2. 설치 프로그램을 실행합니다. 소스에서 빌드할 필요가 없습니다.
  3. 개발자는 UI 데모를 로컬에서 실행할 수 있습니다:
    npm --prefix frontend install
    npm run dev   # 모의 백엔드로 React 개발 서버 시작
    
    모의 백엔드(backend/server.mjs)는 정적 데모 데이터만 제공하며 Douyin에 연결하지 않습니다.

오픈 소스 범위

  • 리포지토리 내용:
    • 프론트엔드 코드(React 컴포넌트, 상태 관리, 스타일링).
    • API 계약을 모방한 모의 Node.js 서버.
    • 공개/비공개 경계를 설명하는 문서.
  • 포함되지 않는 것:
    • 실제 Douyin API 호출, 인증 쿠키, 서명, 복호화 로직.
    • Douyin 서비스 약관을 위반하는 코드(예: 대량 스크래핑, 속도 제한 우회).

라이선스

  • Better Douyin 비상업적 라이선스로 배포 – 개인 학습, 연구, 테스트에는 무료이지만 상업적 재배포나 SaaS 호스팅은 금지됩니다.

대상 사용자

  • 다운로드 관리 기능을 갖춘 데스크톱 우선 Douyin 클라이언트를 원하는 파워 유저.
  • 공개 API 계약을 준수하는 UI/UX 개선이나 자체 백엔드 구축에 관심이 있는 개발자.
  • 로컬 HTTP 인터페이스를 통해 AI 생성 댓글이나 앱 통합을 실험하려는 AI 애호가.

위의 모든 세부 사항은 리포지토리의 README에서 직접 가져온 것이며 추가 기능은 추측되지 않았습니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트