Skip to content

Latest commit

 

History

History
54 lines (40 loc) · 2 KB

README.md

File metadata and controls

54 lines (40 loc) · 2 KB

Tiktok plugin for Grayjay

A plugin for GrayJay that supports Tiktok. This repo is currently a work-in-progress and will be updated regularly.

About

This plugin has 2 parts:

  • Python server: This server scrapes data from tiktok using davidteacher/TiktokApi.
  • Grayjay plugin This plugin communicates with the python server and allows you to view tiktok on your phone.

Current features:

  • search tiktok users
  • view comments
  • view likes
  • watch user videos

Missing features:

  • general search (not just users)
  • comment replies
  • user subscriptions (coming soon)

Preview

preview.mp4

Server setup

# First clone the repo
git clone https://github.com/IntegerOverfl0w/grayjay-tiktok

# Then Setup the python virtual environment using the setup.sh script
sh script.sh && source tt_env/bin/activate

# open up tiktok.com in a browser, click the search bar and search for a user then copy the ms_token cookie from the browser 
# in chrome: right click + Inspect -> Go to the "Application" tab (may be hidden under ">>") ->
# ... Click on Local Storage -> https://www.tiktok.com -> copy the msToken value

# Make sure to open up secrets.py after running this command and paste your MSTOKEN value
cp secrets.sample.py secrets.py

# ..and then run the server
python server.py

Install plugin

qr-code

Click to Install

grayjay://plugin/https://integeroverfl0w.github.io/grayjay-tiktok/TiktokConfig.json

TODO

  • CAPTCHA support
  • Obtain direct video url instead of streaming
  • Reverse engineer signing algorithm and perform it directly in the plugin without having a separate python server.
  • Have a config option for the python server address (need to make a PR to grayjay core as there is no string support, only boolean and dropdown support)