FileConvertLab CLI Reference

FileConvertLab CLI — convert files from the terminal

v0.1.0

Installation

Download the latest release for your platform:

Linux x64fcl-linux-x64.tar.gzLinux ARM64fcl-linux-arm64.tar.gzmacOS Apple Siliconfcl-macos-arm64.tar.gzWindows x64fcl-windows-x64.tar.gz

Usage

fcl <COMMAND> [OPTIONS]

Global Options

--api-url <API_URL>Custom API base URL

--helpPrint help

--versionPrint version

Commands

fcl login

fcl logout

Log out and clear stored credentials

fcl convert

Convert a file to another format

fcl status

Check the status of a conversion job

fcl download

Download a completed conversion result

fcl whoami

Show current user info and limits

`fcl login`

fcl login

`fcl logout`

Log out and clear stored credentials

fcl logout

`fcl convert`

Convert a file to another format

fcl convert [OPTIONS] <FILE>

Arguments

<FILE>Input file path

Options

--to <TO>Target format (e.g., word, pdf, excel, png)

--asyncOnly upload and return job ID, don't wait for completion

-o, --output <OUTPUT>Output file path (default: same name with new extension)

`fcl status`

Check the status of a conversion job

fcl status <JOB_ID>

Arguments

<JOB_ID>Job ID

`fcl download`

Download a completed conversion result

fcl download [OPTIONS] <JOB_ID>

Arguments

<JOB_ID>Job ID

Options

-o, --output <OUTPUT>Output file path

`fcl whoami`

Show current user info and limits

fcl whoami

Examples

Convert a PDF to Word

fcl convert document.pdf --to word

# Saved to document.docx

Convert with custom output path

fcl convert report.pdf --to excel -o report-tables.xlsx

Async conversion (background)

fcl convert large-file.pdf --to word --async

# Job created: a1b2c3d4-...

fcl status a1b2c3d4-...

# Status: COMPLETED

fcl download a1b2c3d4-...

Authentication

fcl login

#   To authenticate, open this URL in a web browser:

#     https://fileconvertlab.com/auth/device

#   Then enter this code: ABCD-1234

fcl whoami

# User: john (john@example.com)

# Credits: 50/min, 200/day

Supported Formats

PDF

wordexcelpowerpointpngjpgtxthtmlmarkdown

Word (.docx, .doc)

pdfpngjpgodtrtftxtepub

Excel (.xlsx, .xls)

pdf

PowerPoint (.pptx, .ppt)

pdf

Text (.txt)

docxodtrtf

RTF (.rtf)

docxodttxt

ODT (.odt)

docxrtftxtepub

HTML (.html)

pdf

Images (.jpg, .png, .webp, .gif, .bmp, .tiff, .svg, .ico, .heic)

jpgpngwebpgifbmptiffsvgicopdf

Audio (.mp3, .wav, .ogg, .flac, .aac, .m4a, .wma)

mp3wavoggflacaacm4awma

Video (.mp4, .avi, .mkv, .mov, .wmv, .flv, .webm)

mp4avimkvmovwmvflvwebmgifmp3

Archives (.zip, .7z, .tar.gz, .tar.bz2, .tar.xz)

zip7ztar.gztar.bz2tar.xz

Environment Variables

FCL_API_URLOverride the API base URL

FCL_ACCESS_TOKENUse a specific access token (skip login)