Dòng lệnh filee

Lệnh filee dùng chung engine và cấu hình sẵn với ứng dụng, chạy được trong script, tác vụ định kỳ hay máy chủ không có màn hình. Thông báo mặc định bằng tiếng Việt; đặt FILEE_LANG=en để dùng tiếng Anh. Tên khóa trong đầu ra JSON giữ nguyên như Filee gốc nên script viết cho Filee vẫn chạy.

filee convert anh.heic --to jpg
filee convert *.png --to webp --quality 80 -o da-chuyen
filee convert D:\BanScan --recursive --preset to-pdf
filee watch D:\HopThuDen --to pdf --move-originals
filee engines install pandoc

Cài lệnh filee

Bộ cài Windows có tùy chọn thêm lệnh filee vào PATH. Trên Linux và macOS, install.sh trong gói cài luôn lệnh này. Kiểm tra bằng filee version; xem trợ giúp bằng filee help hoặc filee help <lệnh>.

filee convert

filee convert <tệp hoặc thư mục...> (--to <định dạng> | --preset <preset>) [tùy chọn]

Tệp có thể dùng ký tự đại diện (*.heic). Với thư mục, tsudev-files chuyển các tệp bên trong mà nó nhận diện được.

Tùy chọn	Ý nghĩa
`-t, --to <định dạng>`	Định dạng đích, ví dụ jpg, png, pdf, docx, mp4 (xem filee formats)
`-p, --preset <preset>`	Một cấu hình sẵn của ứng dụng, theo id hoặc tên (xem filee presets)
`-o, --output <thư mục>`	Lưu vào thư mục này thay vì cạnh tệp nguồn
`-r, --recursive`	Bao gồm thư mục con
`--sort <thứ tự>`	Thứ tự ghép tệp: name, name-desc, modified, modified-desc, created, created-desc
`-q, --quality <1-100>`	Chất lượng ảnh cho JPG, WebP, AVIF...
`--pages <khoảng>`	Các trang PDF, ví dụ 13-55 hoặc 1-3,8,12-15
`--overwrite`	Ghi đè tệp kết quả đã có (mặc định: thêm số thứ tự)
`--skip`	Bỏ qua nếu tệp kết quả đã có
`--keep-dates`	Giữ ngày tạo, ngày sửa của tệp gốc cho tệp đã chuyển
`--zip`	Gói kết quả của mỗi tệp thành một ZIP (các tệp của Shapefile đi cùng nhau)
`--json`	In kết quả dạng JSON cho script; sự kiện tiến độ ghi ra stderr
`--quiet`	Chỉ in lỗi

filee watch

filee watch <thư mục> (--to <định dạng> | --preset <preset>) [tùy chọn]

Chuyển đổi các tệp được đưa vào thư mục cho tới khi nhấn Ctrl+C. Tệp chỉ được chuyển khi đã hoàn chỉnh (không còn tăng dung lượng, không bị chương trình khác mở). Kết quả lưu vào thư mục converted bên trong, trừ khi có -o.

Tùy chọn	Ý nghĩa
`-t, --to <định dạng>`	Định dạng đích
`-p, --preset <preset>`	Một cấu hình sẵn, theo id hoặc tên
`-o, --output <thư mục>`	Nơi lưu tệp đã chuyển (mặc định: <thư mục>/converted)
`-r, --recursive`	Theo dõi cả thư mục con, kết quả giữ nguyên cấu trúc
`--move-originals`	Chuyển tệp nguồn đã xử lý vào <thư mục>/originals; tệp đang chờ sẵn được chuyển ngay khi bắt đầu
`--settle <giây>`	Thời gian tệp phải giữ nguyên không đổi trước khi chuyển (mặc định 5)
`--keep-dates, --zip, --json, --quiet`	Như ở filee convert

filee formats, filee presets

filee formats [<định dạng>] [--json]    # mọi định dạng, hoặc một định dạng chuyển được sang đâu
filee presets [--json]                   # cấu hình sẵn đã lưu (có sẵn và do bạn tạo)

filee engines

filee engines [--json]
filee engines install <engine> [--json] [--quiet]
filee engines remove <engine> [--json] [--quiet]

Liệt kê engine tùy chọn (LibreOffice, Pandoc, FFmpeg...), hoặc cài, gỡ một engine với cùng nguồn tải và cùng bước kiểm SHA-256 như ứng dụng. remove chỉ gỡ những gì tsudev-files đã tải; bản riêng của bạn và bản tìm thấy trên máy được giữ nguyên.

Đầu ra JSON cho script

Với --json, filee convert in một tài liệu JSON ra stdout khi xong việc. Trong lúc chạy, stderr nhận mỗi dòng một đối tượng JSON:

{"event":"progress","source":"...","fraction":0.42}     # 0 tới 1, khoảng 150 ms một lần khi có thay đổi
{"event":"file", ...}                                    # từng tệp xong, cùng trường như mục của tệp đó trong "files"

filee watch --json chỉ in sự kiện ra stdout: started (kèm thư mục, cấu hình sẵn, định dạng đích, thư mục kết quả), file khi từng tệp xong, và stopped khi nhấn Ctrl+C.

Mã thoát

Mã	Nghĩa
`0`	Không có lỗi (kể cả khi có tệp bị bỏ qua)
`1`	Có tệp lỗi hoặc bị hủy
`2`	Sai tham số hoặc thiếu đầu vào
`3`	Không có gì để chuyển đổi