Chánh Điện Online cho TikTok LIVE: người xem vào tụng kinh, tặng quà hồi hướng, xin xăm

tobi•02/11/2026• … views

Bạn từng thấy những phòng TikTok LIVE mà người xem chỉ cần vào xem là “hiện hình” ngay trên màn hình chưa? Chánh Điện Online — tên đầy đủ là Chánh Điện Tịnh Tâm — là một dự án mã nguồn mở miễn phí (giấy phép MIT) biến phòng live của bạn thành một chánh điện 2.5D: 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 ghi tên hồi hướng trên màn hình; còn có nhạc thiền, chuông, mõ, kinh hiện định kỳ và cả tính năng xin xăm.

Bài này giới thiệu chi tiết Chánh Điện Online: người xem làm được gì, chủ phòng live được gì, cách cài đặt chạy trên máy của bạn từng bước (kèm bản đóng gói sẵn cho Windows không cần cài Node), cơ chế bảo mật của dự án và những lưu ý quan trọng trước khi dùng. Toàn bộ mã nguồn được chia sẻ công khai trên GitHub, bạn tải về, tự chạy trên máy mình và tự chỉnh sửa theo ý thích.

1. Chánh Điện Online là gì?

Chánh Điện Online (Chánh Điện Tịnh Tâm) là chánh điện ảo 2.5D được thiết kế chuyên cho TikTok LIVE. Thay vì phòng live chỉ có hình chủ phòng và dòng bình luận chạy qua, Chánh Điện Online tạo ra một không gian chung: mỗi khán giả là một nhân vật ngồi trong chánh điện, bình luận hiện thành bong bóng chữ trên đầu, tặng quà thì được lên bàn thờ dâng lễ và ghi tên hồi hướng.

Một ghi nhận quan trọng về nguồn gốc: Chánh Điện Tịnh Tâm là dự án gốc do tác giả kentjuno phát triển và chia sẻ công khai trên GitHub — bản gốc có giọng đọc hồi hướng tiếng Việt bằng Edge TTS. Bài viết này giới thiệu phiên bản tại repo tobi1008, là bản có thêm các tính năng xin xăm, bộ lọc từ tục tĩu tiếng Việt, bản đóng gói Windows và tự cập nhật qua GitHub Releases. Cả hai phiên bản đều phát hành theo giấy phép MIT.

Dự án gồm hai phần độc lập:

Phần	Nằm ở đâu	Dùng để làm gì
Bản web tĩnh	`index.html`, thư mục `assets/`	Trang chánh điện cho mọi người tự vào ngồi tụng, đăng miễn phí lên Cloudflare Pages
Bộ công cụ phát LIVE	Thư mục `live/`	Server Node chạy trên máy người phát, overlay dọc 9:16 và bảng điều khiển để kết nối phòng TikTok LIVE thật

Nói cách khác, bản web tĩnh phù hợp nếu bạn chỉ muốn một trang chánh điện online cho cộng đồng vào ngồi thiền, tụng kinh cùng nhau. Còn nếu bạn là chủ phòng TikTok LIVE, bộ công cụ trong live/ mới là phần “ăn tiền”: nó đọc sự kiện công khai của phòng live (ai vào, ai bình luận, ai tặng quà, ai thả tim) rồi vẽ lại toàn bộ lên overlay 9:16 để phát lên TikTok.

Minh họa chánh điện online 2.5D trên TikTok LIVE: người xem ngồi bồ đoàn trước chánh điện, bên cạnh là điện thoại phát live

2. Người xem làm được gì trong Chánh Điện Online?

Điểm hay nhất của Chánh Điện Online là người xem không phải cài thêm gì cả. Họ chỉ xem live như bình thường, mọi tương tác quen thuộc của TikTok đều biến thành hành động trong chánh điện.

2.1. Vào xem là được ngồi vào chánh điện

Ngay khi vào phòng live, người xem được chào bằng ảnh đại diện và tên, sau đó nhân vật của họ ngồi xuống một bồ đoàn trong chánh điện. Chỉ có người xem thật mới được ngồi — dự án không dùng bot hay nhân vật mẫu để “làm màu” cho đông.

Số người ngồi không bị giới hạn cứng. Chánh điện tự nới rộng theo các mức 24 → 36 → 64 → 100 người, rồi tiếp tục tăng theo bước 50. Khi quá 100 người, để màn hình đỡ rối, chánh điện chỉ hiện bảng tên của những người đang hoạt động: vừa bình luận, vừa vào hoặc vừa tặng quà.

Khi có người rời live, TikTok không gửi thông báo ai đã rời đi, nên Chánh Điện Online xử lý theo số người đang xem thực tế: nếu Số người ngồi nhiều hơn số người xem, người im lặng lâu nhất sẽ rời chánh điện trước. Người tặng quà rời sau cùng, ai vừa hoạt động trong vòng 1 phút được giữ lại. Người xem quay lại phòng thì được ngồi lại như cũ. Cơ chế này tắt được trong bảng điều khiển nếu bạn không thích.

2.2. Bình luận hiện trên đầu, gõ một từ là đổi nhân vật

Bình luận bất kỳ sẽ hiện thành bong bóng chữ ngay trên đầu nhân vật của người bình luận (người chưa ngồi thì được ngồi luôn). Bình luận dài tự xuống dòng, tối đa 5 dòng, hiển thị được cả emoji và sticker TikTok.

Có một “mật khẩu” rất vui: bình luận đúng một từ nam, nữ, sư, ni, tiểu, bà hoặc cao tăng thì nhân vật đổi sang hình tương ứng. Bạn không cần lo bị hiểu nhầm — câu “Nam mô A Di Đà Phật” không bị nhận nhầm thành từ khóa nam, vì hệ thống chỉ khớp khi bình luận gồm đúng một từ đó.

Thả tim thì tim bay trên đầu nhân vật — đơn giản, nhưng lên hình live rất sinh động.

2.3. Tặng quà: ghi tên hồi hướng và dâng lễ trên bàn thờ

Đây là tính năng trung tâm của Chánh Điện Online. Khi người xem tặng quà:

Một banner ghi tên hồi hướng hiện trên màn hình. Nếu người tặng vừa bình luận lời nguyện gần đó, hệ thống lấy chính lời nguyện ấy đưa vào banner.
Hiệu ứng hiển thị thay đổi theo giá trị món quà, đồng thời cộng điểm vào bảng Công Đức trên màn hình.
Người tặng đứng dậy, bước lên bàn thờ dâng lễ: quà hoa (như Rose) thì dâng hoa sen, các quà khác thì dâng hương.
Màn hình zoom cận vào người đang dâng lễ khoảng 4 giây rồi trở lại toàn cảnh. Nhiều người tặng liền nhau thì dâng lễ lần lượt từng người, không tranh nhau.

Lưu ý nhỏ: chỉ người tặng quà mới được zoom lên bàn thờ. Gõ chữ “thắp nhang” trong bình luận thì không — tránh được tình trạng spam chữ để chiếm màn hình.

2.4. Xin xăm ngay trong phòng live

Mỗi lần tặng quà, người xem nhận 1 lượt xin xăm (giữ tối đa 3 lượt). Gõ xin xăm là nhân vật lên bàn thờ lắc ống xăm, màn hình zoom theo, rồi hiện quẻ xăm gồm: số xăm, mức quẻ, 4 câu thơ và lời giải. Bạn cũng có thể gõ xin xăm trước rồi tặng quà trong vòng 3 phút, thứ tự nào cũng tính.

Nếu chưa tặng quà mà gõ xin xăm, hệ thống chỉ hiện bong bóng nhỏ trên đầu nhắc tặng quà — không banner, không chuông — nên phòng live không bị làm phiền. Bộ 30 quẻ nằm trong file live/xam.mjs, bạn sửa nội dung hoặc thêm quẻ mới thoải mái. Tính năng xin xăm tắt được trong bảng điều khiển.

3. Bộ lọc từ tục tĩu tiếng Việt

Phát live có khán giả lạ thì rủi ro lớn nhất là bình luận và tên người xem chứa từ tục tĩu hiện thẳng lên màn hình. Chánh Điện Online có sẵn tab Bộ lọc trong bảng điều khiển, lọc cả tên lẫn bình luận bằng danh sách từ cấm tiếng Việt và tiếng Anh trong file live/filter.mjs.

Bộ lọc này được làm khá kỹ cho tiếng Việt: bắt được các kiểu lách phổ biến như viết tắt có dấu chấm (đ.m), tách chữ (v c l), thay số vào chữ (l0z), kéo dài chữ (lồnnn) hay viết không dấu — nhưng không chặn nhầm các từ sạch dễ dính oan như “lớn”, “buổi”, “tổ sư” hay “bà vãi”. Đây là chi tiết mà ai từng tự viết bộ lọc tiếng Việt đều biết là khó: lọc mạnh tay thì chặn oan người lành, lọc nhẹ thì lọt hết.

Cách xử lý khi dính từ cấm:

Bình luận chứa từ cấm bị ẩn đi, hoặc hiện dạng *** tùy cài đặt, và không bao giờ được dùng làm lời nguyện hồi hướng.
Tên người xem chứa từ cấm hiển thị thành “Phật tử ẩn danh”.
Vi phạm đủ số lần (mặc định 3 lần) thì tự động bị mời ra khỏi chánh điện và chặn. Chủ phòng cũng chặn tay được từ danh sách người xem.
Bạn thêm được từ cấm riêng của kênh mình, và thử một câu bất kỳ ngay trên bảng điều khiển trước khi lên sóng.

Mọi cài đặt được lưu vào live/config.json và giữ nguyên sau khi khởi động lại server.

4. Cách cài đặt và chạy Chánh Điện Online

Minh họa phòng điều khiển phát live: laptop bảng điều khiển, màn hình overlay 9:16 và server chạy trên máy người phát

4.1. Chạy từ mã nguồn (cần Node.js 20 trở lên)

Trên máy phát live (Windows, macOS hay Linux đều được), bạn tải mã nguồn từ GitHub rồi chạy:

git clone https://github.com/tobi1008/chanh-dien-online.git
cd chanh-dien-online/live
npm install
npm start

Sau khi server chạy, làm tiếp 4 bước:

Mở bảng điều khiển tại http://localhost:3000/live/control.html.
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 nên phải bấm tay lần đầu.
Đưa overlay vào phần mềm phát live: với TikTok LIVE Studio, chọn Add source → Window capture rồi chọn cửa sổ overlay; với OBS, dùng Browser source trỏ tới http://localhost:3000/live/overlay.html, kích thước 1080×1920.
Bật LIVE trên TikTok, nhập @username kênh của bạn vào bảng điều khiển rồi bấm Kết nối.

Chưa cần live thật vẫn kiểm tra được toàn bộ: tab Kiểm tra trong bảng điều khiển cho phép giả lập một người vào xem, bình luận, tặng quà để bạn xem trước hiệu ứng. Trước khi lên sóng thật, nhớ bấm Làm trống toàn bộ bồ đoàn để dọn sạch dữ liệu thử.

Ảnh terminal kết quả chạy thật Chánh Điện Online: cài 60 gói npm, trang điều khiển và overlay trả mã 200, thử truy cập .git/config và file server đều bị chặn 404, Host giả bị chặn 421

4.2. Bản Windows đóng gói sẵn — không cần cài Node

Nếu máy phát là Windows 10/11 và bạn không rành kỹ thuật, dự án có sẵn bản đóng gói: file zip khoảng 44 MB chứa sẵn node.exe (Node 24 LTS, có kiểm tra mã băm SHA-256 đối chiếu với nodejs.org), server, thư viện và file Mo-Chanh-Dien.bat. Bạn chỉ cần giải nén, bấm đúp Mo-Chanh-Dien.bat và làm theo file HUONG-DAN.txt đi kèm. Các bản đóng gói này nằm trong mục Releases trên GitHub.

4.3. Tự cập nhật qua GitHub Actions

Mỗi khi mã nguồn trên nhánh main thay đổi ở các thư mục live/, assets/ hoặc pack/, GitHub Actions tự chạy quy trình đóng gói và tạo GitHub Release mới (hiện dự án đã có 9 bản phát hành). Máy Windows đang dùng bản zip chỉ cần vào bảng điều khiển → Kiểm tra cập nhật → Cập nhật ngay là lên bản mới, không phải tải lại thủ công. Sau khi đẩy code, bản phát hành mới thường xuất hiện sau khoảng 2–3 phút.

5. Bảo mật: an toàn ngay từ mặc định

Một công cụ đọc dữ liệu TikTok LIVE rất dễ làm người dùng lo ngại về tài khoản. Chánh Điện Online được viết theo hướng an toàn mặc định, và đây là phần mình đánh giá cao nhất ở dự án này:

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

Đây không chỉ là lời giới thiệu suông: mình đã tự clone mã nguồn về, chạy server thật và kiểm tra lại vào ngày 02/11/2026. Kết quả đúng như tài liệu mô tả — trang bảng điều khiển và overlay trả mã 200; thử truy cập .git/config, package.json, đường dẫn ../server.mjs và %2e%2e/server.mjs đều bị chặn 404; gửi header Host giả bị chặn 421. Bạn xem ảnh terminal ở mục 4.1 để thấy kết quả chạy thật này.

6. Lưu ý quan trọng trước khi dùng

Thư viện kết nối TikTok là của cộng đồng. tiktok-live-connector không phải API chính thức của TikTok, nên có thể ngừng hoạt động khi TikTok thay đổi hệ thống. Bạn nên đọc kỹ điều khoản của TikTok trước khi dùng cho kênh của mình.
Tài nguyên hình ảnh, âm thanh là AI tạo. Hình trong thư mục assets/ được tạo bằng Google Flow, nhạc nền tạo bằng Gemini. Nếu dùng cho mục đích thương mại, hãy kiểm tra điều khoản của các dịch vụ đó, hoặc thay bằng tài nguyên của riêng bạn.
Đây là phần mềm miễn phí “nguyên trạng”. Theo miễn trừ trách nhiệm đi kèm dự án, phần mềm được chia sẻ cho mục đích học tập và tham khảo lập trình, không kèm bảo đảm. Người dùng tự chịu trách nhiệm về nội dung mình phát, việc nhận quà/donate và việc tuân thủ pháp luật nơi mình sinh sống (kể cả quy định về hoạt động tôn giáo, quảng cáo, thuế, bản quyền).
Giữ sự tôn kính. 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. Nếu dùng Chánh Điện Online, hãy dùng với thái độ tôn kính, 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.

7. Ai nên dùng Chánh Điện Online?

Chánh Điện Online hợp với:

Chủ kênh TikTok LIVE làm nội dung tụng kinh, thiền, chia sẻ Phật pháp muốn phòng live có không gian riêng thay vì giao diện mặc định.
Người muốn tăng tương tác giữ chân khán giả: người xem được “hiện diện” thật trong chánh điện, có bảng Công Đức, có xin xăm — những thứ khiến họ ở lại lâu hơn hẳn so với chỉ đọc bình luận.
Bạn dev muốn học cách làm overlay tương tác cho livestream bằng Node.js và WebSocket: mã nguồn mở MIT, cấu trúc rõ ràng (server, overlay, bảng điều khiển, bộ lọc, bộ quẻ xăm tách file riêng), sửa và mở rộng thoải mái.

Ngược lại, nếu bạn kỳ vọng một công cụ chính thức từ TikTok với cam kết hoạt động lâu dài, thì không công cụ cộng đồng nào đáp ứng được — như đã nói ở mục lưu ý, thư viện kết nối có thể bị ảnh hưởng bất cứ khi nào TikTok đổi hệ thống.

Kết luận

Chánh Điện Online (Chánh Điện Tịnh Tâm) là một dự án nhỏ nhưng làm rất tới nơi: trải nghiệm người xem có chiều sâu (ngồi bồ đoàn, đổi nhân vật, dâng lễ hồi hướng, xin xăm), bộ lọc tiếng Việt thực dụng cho kênh Việt, bản Windows đóng gói sẵn cho người không rành kỹ thuật, tự cập nhật qua GitHub Releases, và tư duy bảo mật “an toàn mặc định” hiếm thấy ở các công cụ livestream miễn phí. Nếu bạn đang làm kênh TikTok LIVE về tụng kinh, thiền định, hãy tải về chạy thử ở tab Kiểm tra trước — hợp thì lên sóng, không hợp thì thôi, vì mọi thứ đều miễn phí và chạy ngay trên máy bạn.

Câu hỏi thường gặp

Chánh Điện Online có miễn phí không? Có. Toàn bộ mã nguồn được phát hành theo giấy phép MIT trên GitHub: tải về, sử dụng, chỉnh sửa và chia sẻ lại đều được, chỉ cần giữ thông tin giấy phép theo quy định của MIT.

Dùng Chánh Điện Online có phải đưa tài khoản TikTok không? Không. Công cụ chỉ đọc sự kiện công khai của phòng live theo username. Bạn không phải nhập mật khẩu, cookie hay session, và công cụ không thể gửi tin nhắn thay bạn.

Máy tính yếu có chạy được không? Tôi không biết lập trình. Được, nếu máy chạy Windows 10/11: dùng bản zip đóng gói sẵn trong mục Releases trên GitHub, giải nén rồi bấm đúp file Mo-Chanh-Dien.bat. Bản này đã chứa sẵn Node, bạn không cần cài thêm gì và không cần biết lập trình.

Người xem có cần cài app hay đăng ký không? Không. Người xem chỉ vào phòng TikTok LIVE như bình thường: vào xem, bình luận, thả tim, tặng quà — mọi tương tác đều được Chánh Điện Online thể hiện lên màn hình.

Xin xăm trong Chánh Điện Online hoạt động thế nào? Mỗi lần tặng quà bạn nhận 1 lượt xin xăm (tối đa 3 lượt). Gõ xin xăm để lắc ống xăm và nhận quẻ gồm số xăm, mức quẻ, 4 câu thơ và lời giải. Chủ phòng chỉnh sửa hoặc thêm quẻ trong file live/xam.mjs.

Chánh Điện Online có phải của một ngôi chùa nào không? Không. Đây là dự án phần mềm cá nhân chia sẻ miễn phí, không đại diện cho bất kỳ chùa, tu viện hay tổ chức tôn giáo nào.

Nguồn tham khảo

Chuyên mục:GitHub