Chánh Điện Tịnh Tâm

Chánh điện online 2.5D cho TikTok LIVE. Mỗi người xem bình luận là bước vào chánh điện, ngồi xuống bồ đoàn tụng kinh. Ai tặng quà sẽ được xướng tên hồi hướng bằng giọng đọc tiếng Việt. Có nhạc thiền, chuông, mõ và đọc kinh định kỳ.

Mã nguồn chia sẻ miễn phí (MIT). Có hai phần:

Chạy bộ LIVE trên máy phát

Cần Node.js 20 trở lên.

cd live
npm install
npm start

1. Mở http://localhost:3000/live/control.html (bảng điều khiển).
2. Bấm Mở màn hình overlay 9:16, rồi bấm Bật âm thanh một lần trong cửa sổ đó (trình duyệt chặn tự phát tiếng).
3. Trong TikTok LIVE Studio: Add source → Window capture → chọn cửa sổ overlay. Với OBS thì dùng Browser source trỏ tới http://localhost:3000/live/overlay.html, kích thước 1080×1920.
4. Bật LIVE trên TikTok, nhập @username vào bảng điều khiển, bấm Kết nối.

Chưa live vẫn thử được: dùng Thử tương tác, Đổ người mẫu 15/36/64/100 hoặc Bot mô phỏng.

Người xem làm được gì

• Bình luận bất kỳ: được vào ngồi (tối đa 100 chỗ, chỗ ngồi tự mở rộng 24 → 36 → 64 → 100). Đầy chỗ thì người im lặng lâu nhất mà chưa tặng quà sẽ nhường chỗ.
• Bình luận đúng một từ nam, nữ, sư, ni, tiểu, bà, cao tăng: đổi hình nhân vật. Câu "Nam mô A Di Đà Phật" không bị hiểu nhầm thành "nam".
• Tặng quà: banner xướng tên, giọng đọc hồi hướng (lấy lời nguyện từ bình luận gần nhất của người đó nếu có), hiệu ứng theo giá trị quà, cộng điểm vào bảng Công Đức.
• Thả tim: tim bay trên đầu nhân vật.

Bảo mật

Dự án được viết để ai tải về chạy cũng an toàn mặc định:

• Không dùng tài khoản TikTok. Server chỉ đọc sự kiện công khai của phòng live theo username. Không cần, không hỏi và không lưu mật khẩu, cookie hay session. Không gửi tin nhắn thay bạn.
• Chỉ mở trên máy mình. Server lắng nghe 127.0.0.1, máy khác trong mạng hay Internet không truy cập được. Muốn mở ra ngoài phải tự đặt biến HOST. Không nên làm vậy khi chưa thêm đăng nhập.
• Chặn trang web lạ điều khiển. WebSocket chỉ nhận kết nối từ chính trang của server (kiểm tra Origin), và header Host phải là localhost (chống DNS rebinding). Một trang web khác đang mở trong cùng trình duyệt không gửi được lệnh. Cửa sổ overlay chỉ nhận dữ liệu, không gửi lệnh được.
• File tĩnh có danh sách trắng. Chỉ phục vụ /assets và /live. Chặn file ẩn (.git, .env), node_modules, mã server, package.json và mọi đường dẫn ../.
• Không tin dữ liệu vào. Tên người xem, bình luận và tên quà đều bị cắt độ dài. Cài đặt chỉ nhận đúng khóa, đúng kiểu, trong giới hạn. Văn bản đưa vào giọng đọc được escape XML. Mọi chữ trên màn hình vẽ bằng textContent hoặc canvas, không chèn HTML, nên bình luận chứa mã độc chỉ hiện ra như chữ thường.
• Chống spam. Hàng đợi giọng đọc tối đa 15 câu. Bình luận thường không đọc thành tiếng.
• Phụ thuộc ghim phiên bản trong live/package.json: ws, msedge-tts, tiktok-live-connector. Không có khóa API nào trong mã.

Các lớp trên đã được thử: đường dẫn ../, %2e%2e, .git/config, server.mjs, package.json đều trả 404. Host giả trả 421. WebSocket từ Origin lạ bị từ chối. Lệnh gửi từ overlay bị bỏ qua. Cài đặt sai kiểu bị kẹp về giới hạn.

Lưu ý

• tiktok-live-connector là thư viện cộng đồng, không phải API chính thức của TikTok. Nó có thể ngừng chạy khi TikTok đổi hệ thống. Kiểm tra điều khoản TikTok trước khi dùng cho kênh của bạn.
• Giọng đọc dùng dịch vụ Read Aloud của Microsoft Edge qua mạng (giọng Nam Minh, Hoài My). Máy phát cần có Internet.
• Hình ảnh trong assets/ được tạo bằng Google Flow, nhạc nền tạo bằng Gemini. Kiểm tra điều khoản của các dịch vụ đó trước khi dùng thương mại, hoặc thay bằng tài nguyên của bạn.

Miễn trừ trách nhiệm

Dự án được chia sẻ miễn phí, với mục đích học tập và tham khảo lập trình. Phần mềm được cung cấp "nguyên trạng" (AS IS), không kèm bất kỳ bảo đảm nào, rõ ràng hay ngụ ý.

Khi tải về, sử dụng, chỉnh sửa hoặc phân phối lại mã nguồn này, bạn tự chịu hoàn toàn trách nhiệm về:

• Mọi nội dung bạn phát trên livestream hoặc đăng tải, bao gồm hình ảnh, âm thanh, giọng đọc, lời nguyện, bình luận được hiển thị.
• Việc nhận quà, donation hoặc bất kỳ khoản thu nào từ người xem.
• Việc tuân thủ điều khoản sử dụng của TikTok và các nền tảng, dịch vụ bên thứ ba khác (thư viện đọc sự kiện TikTok là thư viện cộng đồng, không chính thức).
• Việc tuân thủ pháp luật nơi bạn sinh sống và hoạt động, kể cả quy định về hoạt động tôn giáo, quảng cáo, thuế và bản quyền.
• Mọi rủi ro và thiệt hại phát sinh, trực tiếp hay gián tiếp, như bị khóa tài khoản, bị dừng live, mất dữ liệu, tranh chấp hay khiếu nại.

Tác giả không liên quan, không bảo trợ và không chịu trách nhiệm đối với bất kỳ kênh, tài khoản, sản phẩm hay hoạt động nào sử dụng mã nguồn này. Dự án không đại diện cho bất kỳ chùa, tu viện hay tổ chức tôn giáo nào. Khi dùng nội dung liên quan đến Phật giáo, xin giữ sự tôn kính và không dùng vào mục đích lừa đảo, trục lợi hay xúc phạm niềm tin của người khác.

Việc sử dụng mã nguồn đồng nghĩa với việc bạn đã đọc và đồng ý với các điều trên.

Disclaimer (EN): This project is shared free of charge for educational purposes only and is provided "AS IS", without warranty of any kind. Anyone who uses, modifies or redistributes it is solely responsible for their own content, streams, donations, compliance with TikTok and other platforms' terms, and applicable laws. The author is not affiliated with, does not endorse, and accepts no liability for any channel, account, product or activity built with this code, nor for any direct or indirect damages.

Ủng hộ tác giả

Dự án chia sẻ miễn phí. Nếu thấy hữu ích và muốn góp chút công đức để tác giả duy trì và làm thêm tính năng, bạn có thể chuyển khoản:

Xin cảm ơn và chúc bạn thân tâm an lạc. Nam mô A Di Đà Phật.

Giấy phép

MIT, xem LICENSE.