JKVideo

A feature-rich React Native video client

DASH playback · Real-time danmaku · WBI signing · Live streaming · Cross-platform

---

中文 · Quick Start · Features · Contributing

---

Screenshots

Home · Inline Video · Live Cards	Video Detail · Info · Recommendations	Player · 4K HDR · Quality Switch
Downloads · LAN Share QR Code	Live Tab · Followed Streamers · Categories	Live Room · Real-time Danmaku · Guard Marks

---

Features

🎬 Full DASH Playback DASH stream → buildDashMpdUri() local MPD → ExoPlayer native decode, supports 1080P+ & 4K HDR

💬 Complete Danmaku System Video danmaku with XML timeline sync + 5-lane floating overlay; Live danmaku via WebSocket with guard marks & gift counting

🔐 WBI Signing Pure TypeScript MD5 implementation, zero external crypto dependencies, 12h auto-cached nav interface

🏠 Smart Home Layout BigVideoCard inline DASH muted autoplay + swipe-to-seek gesture + live card interleaving + dual-column grid

📺 Global Mini Player Persistent bottom overlay player survives navigation, VideoStore cross-component state sync

🔑 QR Code Login QR code generation + 2s polling + automatic SESSDATA extraction from response headers

📥 Download + LAN Sharing Multi-quality background download, built-in HTTP server generates LAN QR code for same-Wi-Fi playback

🌐 Cross-Platform Android · iOS · Web, Expo Go scan-to-run in 5 minutes, Dev Build unlocks full DASH playback

---

Tech Stack

Layer	Technology
Framework	React Native 0.83 + Expo SDK 55
Navigation	expo-router v4 (file-based, Stack)
State	Zustand
HTTP	Axios
Storage	@react-native-async-storage/async-storage
Video	react-native-video (DASH MPD / HLS / MP4)
Fallback	react-native-webview (HTML5 video injection)
Pager	react-native-pager-view
Icons	@expo/vector-icons (Ionicons)

---

Quick Start

Option 1: Expo Go (5 minutes, no build required)

Some quality options limited; video falls back to WebView

git clone https://github.com/tiajinsha/JKVideo.git
cd JKVideo
npm install
npx expo start

Scan the QR code with Expo Go on Android or iOS.

Option 2: Dev Build (Full features, recommended)

Supports DASH 1080P+ native playback, full danmaku system

npm install
npx expo run:android   # Android
npx expo run:ios       # iOS (requires macOS + Xcode)

Option 3: Web

npm install
npx expo start --web

Web requires a local proxy server for image anti-hotlinking: node scripts/proxy.js (port 3001)

Direct Install (Android)

Download the latest APK from Releases — no build needed.

Enable "Install from unknown sources" in Android settings

---

Project Structure

app/
  index.tsx            # Home (PagerView Hot/Live tabs)
  video/[bvid].tsx     # Video detail (player + info/comments/danmaku)
  live/[roomId].tsx    # Live room (HLS player + real-time danmaku)
  search.tsx           # Search page
  downloads.tsx        # Download manager
  settings.tsx         # Settings (quality + logout)

components/            # UI components (player, danmaku, cards, etc.)
hooks/                 # Data hooks (video list, stream URLs, danmaku, etc.)
services/              # Video platform API wrapper (axios + cookie interceptor)
store/                 # Zustand stores (auth, download, playback, settings)
utils/                 # Utilities (format, image proxy, MPD builder)

---

Known Limitations

Limitation	Reason
4K / 1080P+ requires premium account	API restriction
FLV live streams not supported	Neither HTML5 nor ExoPlayer support FLV; HLS auto-selected
Web requires local proxy	Image CDN Referer anti-hotlinking
Feed / like / collect features	Requires bili_jct CSRF token, not yet implemented
QR code expires after 10 minutes	Close and reopen the login modal to refresh

---

Contributing

Issues and PRs are welcome! Please read CONTRIBUTING.md first.

---

Disclaimer

This project is for personal learning and research purposes only. Not for commercial use. All video content copyright belongs to the original authors and the respective platforms.

---

License

MIT © 2026 JKVideo Contributors

---

If this project helps you, please give it a ⭐ Star!