Dùng Luxel từ lần mở đầu tiên đến tệp xuất cuối cùng.

Cài đặt Luxel

1. Cài đặt và mở Luxel.
2. Giữ ứng dụng ở vị trí ổn định trước khi cấp quyền.
3. Mở Luxel từ Finder hoặc Launchpad.
4. Tìm mục trạng thái Luxel trên thanh menu macOS.

Luxel yêu cầu macOS 26.0 trở lên. Luxel chạy từ thanh menu, vì vậy đây là nơi chính để bắt đầu ghi và mở cài đặt.

Bản ghi đầu tiên

1. Mở Luxel từ thanh menu.
2. Chọn một đích trong Đích, hoặc dùng Vùng để vẽ vùng tùy chỉnh.
3. Chỉ bật Âm thanh hệ thống, Micrô hoặc Camera nếu bản ghi cần.
4. Nhấp Ghi nguồn, Ghi vùng hoặc Ghi âm thanh.
5. Dừng từ điều khiển trạng thái trên thanh menu, điều khiển bản ghi đang chạy hoặc phím tắt.

Bật lời nhắc

1. Mở Cài đặt > Ghi.
2. Bật Thông báo khi phát hiện giọng nói.
3. Đọc thông báo, sau đó chọn Bật để đồng ý.
4. Cho phép thông báo trước, rồi cho phép truy cập micrô.
5. Chọn Mặc định hệ thống hoặc một micrô cụ thể.

Bật Mở khi đăng nhập nếu bạn muốn dùng tính năng sau khi đăng nhập. Phát hiện chỉ hoạt động khi Luxel đang mở.

Chọn điều sẽ xảy ra

Khi Luxel phát hiện tín hiệu, thông báo đưa ra Bắt đầu ghi và Bỏ qua. Bắt đầu ghi sẽ bắt đầu một bản ghi chỉ có âm thanh bằng micrô đã chọn. Bỏ qua không thực hiện hành động nào, còn việc mở thông báo sẽ kích hoạt Luxel mà không ghi.

Chế độ Tập trung và các cài đặt thông báo macOS khác có thể trì hoãn hoặc ẩn lời nhắc. Lời nhắc chỉ là tiện ích, không bảo đảm Luxel nhận ra một cuộc trò chuyện.

Thiết lập Bộ đệm phát lại

1. Mở Cài đặt > Bộ đệm phát lại.
2. Bật Bộ đệm phát lại và chấp thuận lời nhắc lần đầu.
3. Chọn độ dài: 30 giây, 1 phút, 2 phút hoặc 5 phút.
4. Chọn 24 FPS hoặc 30 FPS.
5. Chỉ bật Bao gồm âm thanh hệ thống khi clip cần âm thanh từ Mac.
6. Chọn mở clip trong trình chỉnh sửa hoặc dùng đích xuất nhanh.

Dùng từ menu

1. Khởi động Bộ đệm phát lại từ điều khiển trên thanh menu.
2. Chờ trạng thái chuyển từ đang khởi động sang đang đệm.
3. Nhấp Xuất để lưu khoảng thời gian gần đây đã chọn.
4. Dùng Bắt đầu và Dừng để bật hoặc tắt bộ đệm.
5. Dùng phím tắt Lưu Bộ đệm phát lại hoặc luxel clip cho cùng tác vụ.

Vẽ vùng chọn

Nhấp Vùng để mở lớp chọn toàn màn hình. Kéo để vẽ vùng, đổi kích thước bằng tay cầm hoặc dùng Toàn màn hình để chọn màn hình. Kích thước nhỏ nhất là 32 x 32 pixel.

Mẫu kích thước gồm 1280 x 720, 1920 x 1080 và 800 x 600. Tỷ lệ gồm Tự do, 16:9, 4:3, 1:1, 9:16 và 21:9.

Điều khiển hữu ích

• Chọn điều khiển đếm ngược, dừng sau, âm thanh, camera, tỷ lệ và kích thước.
• Bật hoặc tắt micrô và camera khi quyền cho phép.
• Dùng kính lúp để căn cạnh chính xác.
• Làm tối màn hình khác hoặc khôi phục vùng chọn cuối từ cài đặt Mẫu.
• Mở cài đặt Tập trung từ lời nhắc thông báo nếu muốn ít bị gián đoạn hơn.

Trong trình chỉnh sửa

1. Mở bản ghi có âm thanh trong trình chỉnh sửa.
2. Dùng bản xem trước bản chép lời để tạo hoặc xem văn bản.
3. Tìm văn bản hoặc chọn đoạn để chuyển vị trí phát.
4. Giữ bật Phân đoạn lượt bản chép lời để tự động nhóm lượt nói.
5. Tắt trong Cài đặt > Bản chép lời để tạo bản thô nhanh hơn cho bản ghi dài.

Nhận dạng và quản lý người nói

1. Bật Nhận dạng người nói trong Cài đặt > Bản chép lời.
2. Tạo bản chép lời để tách và gắn nhãn từng giọng nói cục bộ.
3. Trong thẻ Người nói, dùng phát hiện Tự động hoặc đặt số Chính xác hay Khoảng, rồi chạy lại.
4. Phát ví dụ giọng nói, đặt tên, lưu thành Người nói đã biết, gắn với hồ sơ có sẵn hoặc bỏ qua.
5. Bản chép lời sau có thể tự động khớp Người nói đã biết đã lưu.

Hồ sơ giọng nói và xử lý người nói luôn ở trên Mac.

Từ dòng lệnh

luxel transcribe demo.m4a > demo.txt
luxel transcribe demo.mp4 --output demo.json --format json --overwrite
luxel transcribe demo.mp4 --locale en_US --semantic-turns --diarize

Văn bản thuần mặc định được in ra stdout. Dùng --format json để nhận toàn bộ dữ liệu bản chép lời theo lượt, gồm nhãn người nói khi --diarize được bật.

Ghép đôi với Luxel

luxel pair
luxel doctor

Ghép đôi mở lời nhắc phê duyệt hiển thị trong Luxel. Ứng dụng và CLI lưu các bản thông tin xác thực riêng trong Chuỗi khóa macOS. Bạn có thể tắt điều khiển dòng lệnh hoặc thu hồi máy khách trong Cài đặt > Dòng lệnh.

Ví dụ thường dùng

luxel record --display main --fps display --countdown 3
luxel record --active-window --fps 120
luxel toggle --last-area
luxel stop
luxel clip --seconds 30
luxel latest --reveal
luxel preferences

Ví dụ đa phương tiện

luxel record --active-window --preset "Default" --save-to ~/Movies/Luxel
luxel editor ~/Movies/demo.mp4
luxel convert demo.mp4 demo.webm
luxel convert demo.mp4 demo-av1.mp4 --format av1
luxel convert demo.mp4 demo.gif --start 2 --duration 5 --fps 15 --width 800 --height 450
luxel convert demo.mp4 demo.mov --format prores422 --quality high
luxel export request.json output.webm --overwrite --json
luxel transcribe demo.m4a > demo.txt
luxel transcribe demo.mp4 --output demo.json --format json --diarize --overwrite

Kỹ năng cho tác nhân

Cài đặt Luxel Skills để các tác nhân lập trình tương thích có thể sử dụng toàn bộ CLI hoặc tạo bằng chứng WebM tập trung cho việc đánh giá.

npx skills add https://github.com/rawcontext/luxel-skills
npx skills add https://github.com/rawcontext/luxel-skills --skill luxel
npx skills add https://github.com/rawcontext/luxel-skills --skill luxel-evidence

Chọn luxel để tra cứu lệnh và thao tác, hoặc luxel-evidence cho quy trình ghi và đính kèm có chủ đích.

Xem Luxel Skills trên GitHub.

Quyền truy cập thư mục

Luxel có thể dùng thư mục Phim, thư mục bản ghi đã cấu hình và các thư mục bạn phê duyệt trong ứng dụng. Đường dẫn terminal không bao giờ bỏ qua App Sandbox.

luxel access add ~/Desktop/Exports
luxel access check ~/Desktop/Exports/demo.mp4
luxel access list
luxel access revoke <grant-id>

access add mở bộ chọn thư mục của Luxel. Thư mục bạn chọn ở đó là thư mục ứng dụng được cấp quyền dùng.

Bảo mật và quyền riêng tư

Mỗi lần gọi dùng kết nối ngắn hạn đã xác thực trên127.0.0.1. Luxel từ chối máy khách chưa ghép đôi, yêu cầu cũ, nonce phát lại, nội dung bị sửa và điểm cuối không phải loopback. CLI không nhận dấu trang bảo mật của Luxel và không tự xử lý đa phương tiện.

Sơ đồ URL

Luxel đăng ký sơ đồ luxel:// URL. Bắt đầu ghi và lưu bộ đệm có thể cần xác nhận trừ khi bên gọi đã được cấp quyền; các lệnh dừng, tùy chọn và mới nhất mặc định được phép.

luxel://record?target=display&display=main&fps=display&countdown=3
luxel://record?target=activeWindow&preset=Default
luxel://toggle
luxel://stop
luxel://clip?seconds=30
luxel://preferences
luxel://latest?reveal=true

URL x-callback

Lệnh tự động hóa nhận x-success và x-error URL gọi lại. Lệnh tạo tệp thành công nối thêm filePath, lệnh bắt đầu ghi nối thêm recordingID, và lỗi nối thêm errorMessage.

Dùng trực tiếp sơ đồ URL cho tự động hóa x-callback.

Mẫu nhanh

Có thể thêm, nhân bản, xóa, đổi tên và gán mẫu xuất làm mẫu Ghi nhanh. Mẫu hỗ trợ định dạng, quy tắc kích thước, tốc độ khung hình, đích và tác vụ sau. Đích là Thư mục bản ghi hoặc Bảng nhớ tạm. Mẫu nhanh có GIF, MP4, HEVC MP4, ProRes 422 MOV, ProRes 4444 MOV và APNG; WebM cùng AV1 vẫn có trong trình chỉnh sửa và CLI.

Bộ đệm phát lại

Cài đặt Bộ đệm phát lại điều khiển bật/tắt, độ dài clip, 24 hoặc 30 FPS, âm thanh hệ thống, Tiếp tục khi mở và mở clip trong trình chỉnh sửa hay đích xuất nhanh.

Dòng lệnh

Cài đặt Dòng lệnh bật điều khiển ngoài, mở kho CLI, thu hồi máy khách và quản lý thư mục ứng dụng có thể dùng cho yêu cầu dòng lệnh.

Hành vi hệ thống

Cài đặt hệ thống gồm bộ hẹn giờ thanh menu, lời nhắc thông báo, mở khi đăng nhập, cập nhật và ghi nhận.

Locale được hỗ trợ

• Tiếng Anh
• Tiếng Đức (Đức)
• Tiếng Tây Ban Nha (Châu Âu)
• Tiếng Pháp (Pháp)
• Tiếng Italy (Italy)
• Tiếng Nhật (Nhật Bản)
• Tiếng Hàn (Hàn Quốc)
• Tiếng Việt
• Tiếng Trung (Giản thể)
• Tiếng Bồ Đào Nha (Brazil)
• Tiếng Bồ Đào Nha (Bồ Đào Nha)

Lời nhắc quyền

Lời nhắc Camera, micrô, ghi màn hình và nhận dạng giọng nói xuất hiện bằng ngôn ngữ đã chọn. Luxel chỉ yêu cầu từng quyền khi bật tính năng tương ứng hoặc bắt đầu ghi.

Luxel tự động theo cài đặt ngôn ngữ macOS.