LocalSend 中文文档 下载 App

命令行工具:用一条指令发文件和文本

从 v1.18.0 起,官方第一次提供了独立的命令行客户端,与图形应用使用同一套协议、同一个 Rust 网络核心。它适合写脚本、远程终端、或者单纯不喜欢鼠标的用户。

装在哪、怎么调

CLI 随官方发布渠道分发(发布页有对应平台的可执行文件),装好后命令名是 localsend-cli。查看全部选项与快捷键:

localsend-cli --help

注意:CLI 是独立程序,与手机上的图形版是两个东西;它不需要图形界面参与,适合挂在服务器或无桌面的环境里。

发文件与目录

基本用法,参数可以是文件、目录或二者的混合:

localsend-cli send report.pdf photo.jpg ./project-backup

运行后出现发现的设备列表,交互式选择目标,回车开始传输。目录按递归收集,目录层级在接收端保留;空目录不会发送(协议按文件条目组织),原因见整个文件夹怎么传。

免交互指定目标

脚本场景里不想停在设备选择,用目标参数直接指定:

localsend-cli send --to "Cute Tomato" report.pdf
localsend-cli send --to 192.168.27.26 report.pdf

两种写法的规则:设备别名必须能唯一锁定一台已发现的设备;IP 地址则直接向该地址的默认端口 53317 发起 HTTPS 探测,绕过发现流程——正是手动输入 IP 直连的命令行版。

发文本

localsend-cli send --to "Cute Tomato" --text "要发的内容"

管道输入也支持,命令输出直接发出去:

echo "Hello" | localsend-cli send --to "Cute Tomato" --text -

文本规则:超过 64KB 自动转成 txt 文件发送;标准输入要求 UTF-8 编码、上限 16MB,更大的数据请按文件发。

实用场景

边界