1. 项目概述当万能遥控器遇上开源硬件最近在折腾智能家居和影音设备的朋友估计都遇到过“遥控器泛滥”的烦恼。电视、机顶盒、空调、风扇、音响、投影仪……每个设备都配一个专属遥控器不仅占地方关键时刻还总找不到。市面上的万能遥控器要么学习功能有限要么按键布局死板对于极客玩家来说总觉得少了点“灵魂”。今天要聊的这个项目kala13x/flipper-xremote就是为解决这个痛点而生的一个绝佳方案。简单来说它是一个为Flipper Zero设备开发的、功能强大的红外IR和亚千兆赫Sub-GHz万能遥控器应用程序。Flipper Zero本身是一款多功能的便携式安全测试工具因其可爱的海豚造型和强大的可扩展性在极客圈里非常流行。而这个xremote项目则把Flipper Zero彻底变成了一个高度可定制、脚本化、且能模拟复杂协议的超级遥控器。如果你是Flipper Zero的拥有者厌倦了在多个官方App间切换或者觉得官方遥控器功能不够强大那么这个开源项目绝对值得你深入研究。它不仅支持常见的红外家电还能通过Sub-GHz频段控制一些特殊的无线设备如车库门、无线插座等更厉害的是它允许你通过简单的文本文件来定义整个遥控器的界面和逻辑实现一键宏操作、场景切换等高级功能。接下来我就结合自己实际的配置和使用经验带你从零开始玩转flipper-xremote打造属于你自己的终极遥控终端。2. 核心设计思路与架构解析2.1 为什么选择 xremote官方应用的局限性Flipper Zero自带的“红外遥控器”和“Sub-GHz遥控器”应用已经很强大了能学习、发射大部分信号。但用过一段时间后你会发现几个痛点界面固化每个遥控器都是一个独立的.ir或.sub文件切换设备需要退出重选无法在一个界面内集成不同设备的常用按键。功能单一每个按键只能发送单一信号无法实现“按一下先开电视再切换HDMI输入最后调低音量”这样的组合操作。管理繁琐积累了大量遥控文件后查找和归类变得困难。缺乏状态反馈遥控器界面是静态的无法显示当前设备的状态如空调当前模式、温度。flipper-xremote的设计目标就是打破这些限制。它的核心思路是“基于场景的遥控器聚合与自动化”。它不是简单地替换官方应用而是提供了一个框架让你可以自定义界面通过编辑一个文本配置文件xremote.ini自由定义屏幕上显示的按钮、标签、布局。聚合多设备将电视、音响、空调的常用按键按照你的使用习惯组合在同一个控制面板上。实现自动化脚本一个按钮可以触发一系列红外/Sub-GHz命令并加入延时实现复杂的场景控制。动态内容显示可以在屏幕上显示文本信息理论上可以结合传感器实现状态反馈需自行扩展。2.2 项目架构与工作流程理解了目标我们再看它的实现架构。整个项目运行在Flipper Zero上其工作流程可以概括为以下几个步骤配置解析Flipper启动xremote应用后首先会读取SD卡中的/infrared/assets/xremote.ini配置文件。这个文件定义了遥控器的所有元素有哪些页面、每个页面有哪些按钮、每个按钮叫什么名字、长什么样子图标、按下后执行什么操作。界面渲染应用根据配置文件在Flipper的128x64像素单色屏幕上动态绘制出按钮和标签。它采用了一种简单的网格系统来定位元素。事件处理当你按下Flipper的物理按键OK、Back、Up、Down等来导航并点击屏幕上的虚拟按钮时应用会触发对应的事件。命令执行事件对应的“动作”开始执行。动作可以是发送红外信号调用Flipper内置的红外库发射指定名称的.ir信号文件。发送Sub-GHz信号调用Sub-GHz库发射指定名称的.sub信号文件。执行延迟等待若干毫秒用于组合命令间的间隔。界面导航跳转到其他预设的页面。控制应用退出应用或重启Flipper用于高级场景。这个架构的精妙之处在于“配置与代码分离”。绝大部分功能定制都不需要你重新编译C代码只需修改xremote.ini这个文本文件。这极大地降低了使用门槛也让分享和复用遥控器配置变得非常容易。3. 核心配置文件 xremote.ini 深度解析项目的核心就是这个xremote.ini文件。它遵循经典的INI文件格式由节Section、键Key和值Value组成。我们逐部分拆解。3.1 基础节[App] 与 [View]配置文件通常以[App]节开头这里定义应用级设置。[App] version1 nameXRemoteversion配置文件的版本目前似乎固定为1。name显示在应用启动界面的名称可以自定义为你喜欢的名字比如“家庭影院中枢”。接下来是[View]节定义视图即页面的基本属性。[View] idmain width128 height64 start_pagemain_menuid视图的唯一标识符通常就是main。width/height对应Flipper屏幕的分辨率不要修改。start_page应用启动后首先显示的页面名称这里是main_menu。3.2 构建页面[Page:*] 节每一个独立的屏幕就是一个页面。你需要为每个页面创建一个节节名格式为[Page:页面名称]。[Page:main_menu] button_1TV_Power, 10, 10, tv.ir, 发送 button_2AC_Cool, 50, 10, ac_cool.ir, 发送 label_1主菜单, 44, 30页面名称如main_menu用于在其他地方引用这个页面例如在start_page中。定义元素在页面节内通过button_N、label_N、exit_N等键来添加元素。N是从1开始的连续整数不能跳过。按钮语法button_N按钮文本, X坐标, Y坐标, 动作类型:动作参数, 图标名(可选)按钮文本显示在按钮上的字由于屏幕小建议用英文或简短中文需字体支持。X, Y坐标按钮左上角的像素坐标。Flipper屏幕左上角为(0,0)。需要自己计算布局避免重叠。动作类型:动作参数这是核心。常见的有ir:文件名称发送红外信号如ir:tv_power.ir。文件需放在/infrared/assets/目录下。subghz:文件名称发送Sub-GHz信号如subghz:gate_open.sub。文件需放在/subghz/assets/目录下。delay:毫秒数延迟如delay:500。page:页面名称跳转到另一个页面如page:ac_control。run:命令运行内置命令如run:exit退出应用。图标名可选可以指定一个内置图标如发送、电源、播放等让界面更直观。实操心得坐标计算与布局规划在纸上先画一个128x64的网格草图是很有帮助的。一个按钮大约20x20像素加上文本。利用label纯文本元素可以作为分组标题。例如将电视相关按钮放在(10,10)到(50,30)区域空调按钮放在(70,10)到(110,30)区域中间用label标注这样界面清晰不易误操作。3.3 实现复杂逻辑动作序列与变量单个动作能力有限xremote的强大之处在于可以为一个按钮定义动作序列。动作参数可以用|符号连接多个动作。button_3Movie_Mode, 10, 40, delay:200|ir:tv_power.ir|delay:1000|ir:amp_on.ir|delay:500|ir:hdmi1.ir, 播放这个Movie_Mode按钮实现了先等待200毫秒防止误触。发送电视开机红外信号。等待1秒让电视启动。发送功放开机信号。等待500毫秒。切换电视到HDMI1输入。这就实现了一键开启影院模式。更进阶的用法是使用变量。在[Variables]节定义变量然后在动作中用${变量名}引用。[Variables] ac_temp24 [Page:ac_control] button_1Temp_Up, 10, 10, var:ac_tempinc|ir:ac_${ac_temp}_cool.ir button_2Temp_Down, 50, 10, var:ac_tempdec|ir:ac_${ac_temp}_cool.ir label_1温度: ${ac_temp}, 30, 30这个例子实现了定义了一个变量ac_temp初始值24。Temp_Up按钮的动作var:ac_tempinc将变量增加1然后发送名为ac_25_cool.ir的红外信号假设你提前学习了24度、25度、26度等温度的信号文件。Temp_Down按钮同理变量递减。标签label_1会动态显示当前的温度值。注意事项信号文件命名必须规范为了实现上述变量功能你的红外信号文件必须按照ac_24_cool.ir,ac_25_cool.ir这样的模式命名。这需要你在学习原始遥控器信号时就有计划地进行系统化命名和存储。建议为每个设备建立一个清晰的文件夹结构。4. 完整实操从零构建家庭影院遥控面板理论说了这么多我们动手创建一个实用的家庭影院控制面板。假设我们要控制电视、Soundbar音响和一台小米风扇。4.1 准备工作与信号采集硬件准备Flipper Zero充满电。软件准备将flipper-xremote项目文件主要是xremote.c、xremote.h等编译成.fap应用文件或者直接下载作者编译好的版本。将xremote.fap放入Flipper SD卡的/apps/GPIO/目录或其他自定义应用目录。将示例的xremote.ini放入/infrared/assets/目录。采集红外信号使用Flipper官方“红外”应用选择“学习新遥控器”。将原装遥控器对准Flipper的IR接收器按下按键。关键步骤为每个信号起一个唯一且描述清晰的名字并保存到/infrared/assets/目录。例如tv_power.irtv_hdmi1.irtv_vol_up.irsoundbar_power.irsoundbar_optical.irfan_power.irfan_speed1.ir,fan_speed2.ir,fan_speed3.irfan_oscillate.ir可选采集Sub-GHz信号如果你的设备如某些射频风扇、窗帘电机使用433MHz等频率使用“Sub-GHz”应用进行学习同样规范命名后存入/subghz/assets/目录。4.2 编写 xremote.ini 配置文件我们规划两个页面一个主菜单一个风扇专用控制页。[App] version1 name我的影院 [View] idmain width128 height64 start_pagehome [Variables] fan_speed2 # 主页 - 聚合常用功能 [Page:home] # 第一行电视控制 label_1电视, 5, 2 button_1PWR, 5, 12, ir:tv_power.ir, 电源 button_2HDMI1, 30, 12, ir:tv_hdmi1.ir button_3VOL, 55, 12, ir:tv_vol_up.ir button_4VOL-, 80, 12, ir:tv_vol_down.ir # 第二行音响控制 label_2音响, 5, 34 button_5PWR, 5, 44, ir:soundbar_power.ir, 电源 button_6OPT, 30, 44, ir:soundbar_optical.ir # 第三行场景与导航 button_7影院模式, 5, 56, delay:300|ir:tv_power.ir|delay:1000|ir:soundbar_power.ir|ir:tv_hdmi1.ir, 播放 button_8风扇, 60, 56, page:fan_ctrl exit_1退出, 108, 56, run:exit # 风扇控制页 [Page:fan_ctrl] label_1风扇控制, 40, 2 button_1开关, 10, 15, ir:fan_power.ir, 电源 button_2风速, 50, 15, var:fan_speedinc|delay:100|ir:fan_speed${fan_speed}.ir button_3风速-, 90, 15, var:fan_speeddec|delay:100|ir:fan_speed${fan_speed}.ir button_4摆风, 10, 40, ir:fan_oscillate.ir label_2风速: ${fan_speed}, 55, 50 button_5返回, 90, 40, page:home配置解读主页聚合了电视和音响的常用单键功能并设置了一个“影院模式”宏按钮和一个跳转到风扇页的按钮。风扇页展示了变量用法。fan_speed变量初始为2对应speed2。按下“风速”会先增加变量值然后发送对应的风速信号。标签会动态更新显示当前风速档位。布局通过坐标精心排列使同类功能聚集并用标签区分区域。图标为电源键添加了“电源”图标为影院模式添加了“播放”图标提升辨识度。4.3 部署与测试将编辑好的xremote.ini文件覆盖SD卡中原有的文件。在Flipper Zero主界面进入“GPIO”或你存放应用的目录运行XRemote应用。应用启动后你应该能看到“我的影院”启动界面然后进入home页面。使用方向键移动光标一个反色显示的方块按OK键触发按钮。测试单个按钮如电视PWR是否正常响应。测试“影院模式”宏观察设备是否按顺序开启。进入风扇页测试风速加减观察标签数字是否变化风扇风速是否跟随变化。常见问题1按钮按下无反应检查信号文件首先确认ir:tv_power.ir中的tv_power.ir文件是否确实存在于/infrared/assets/目录且名称完全一致包括大小写。检查文件格式确保.ir文件是Flipper Zero官方红外应用生成的正确格式。不要直接复制别人的文件不同设备、不同编码的信号可能不通用最好自己学习。检查动作语法仔细核对动作类型:参数的格式冒号是英文冒号后面没有多余空格。常见问题2界面显示错乱或元素缺失检查坐标确保按钮、标签的坐标没有超出屏幕范围0x128, 0y64且元素之间没有因坐标计算错误导致的重叠覆盖。检查序号连续性button_1,button_2,label_1... 序号必须从1开始连续中间不能跳过。如果定义了button_1和button_3缺少button_2可能会导致解析错误。检查节名称[Page:home]的拼写必须与start_pagehome以及跳转动作page:home中的名称完全一致。5. 高级技巧与扩展思路掌握了基础配置后你可以尝试更高级的玩法让这个遥控器更加智能。5.1 利用“运行”命令实现系统级控制run:命令可以执行一些预定义的系统动作这在创建“总开关”时很有用。button_9重启Flipper, 100, 56, run:reboot这个按钮会重启Flipper Zero设备本身。你可以把它放在一个隐藏的“工程师菜单”页面用于在配置出错导致应用卡死时强制重启当然直接拔电池也行。5.2 创建多层菜单与导航对于控制设备众多的场景可以设计树状菜单。[Page:main_menu] button_1客厅, 10, 10, page:living_room button_2卧室, 50, 10, page:bedroom button_3设置, 90, 10, page:settings [Page:living_room] label_1客厅设备, 40, 2 button_1电视, 10, 20, page:tv_ctrl button_2空调, 50, 20, page:ac_ctrl button_3回主菜单, 90, 50, page:main_menu通过多层页面的跳转可以管理数十个设备而不显得杂乱。5.3 与外部脚本联动进阶xremote本身不支持直接读取传感器或进行复杂逻辑判断。但你可以通过一个“曲线救国”的方式结合Flipper Zero的BadUSB或GPIO脚本功能。编写一个简单的Python脚本在电脑上运行通过串口与Flipper通信。在xremote.ini中设置一个按钮动作为run:exit退出遥控器应用。在Flipper上设置一个“快速应用切换”的快捷键或者让Python脚本通过串口命令启动BadUSB脚本。BadUSB脚本可以读取GPIO连接的传感器如温湿度传感器然后根据数值通过模拟按键操作重新启动xremote并跳转到特定页面甚至通过红外发射特定的温度调节信号。这需要较强的动手能力和对Flipper生态的理解但实现了真正的“环境感知式自动化”。5.4 配置文件的版本管理与分享你的xremote.ini和一堆.ir、.sub文件是宝贵的配置资产。建议在电脑上使用Git进行版本管理每次修改前备份。将/infrared/assets/和/subghz/assets/目录定期备份。可以将你的完整配置去除个人隐私信息后分享到社区帮助其他拥有相同设备型号的玩家快速上手。同样你也可以寻找别人分享的配置文件节省学习信号的时间。6. 常见问题排查与优化实录在实际使用中我踩过不少坑也总结了一些优化经验。问题宏命令执行不稳定有时设备没反应。排查这通常是延时delay设置不合理导致的。不同设备从接收指令到执行完毕所需的“准备时间”不同。解决在宏命令的每个步骤之间插入足够的延时。对于电视、投影仪这类启动慢的设备开机后可能需要delay:20002秒甚至更久。你需要针对自己的设备进行测试和调整。一个稳妥的方法是先设置较长的延时确保每次都能成功再逐步缩短延时找到最稳定、最快速的时间点。问题变量递增/递减后发送的信号不对。排查检查变量操作和信号发送是否在同一个动作序列里完成。确保信号文件命名包含了变量值且文件存在。解决参考前面风扇的例子使用var:fan_speedinc|ir:fan_speed${fan_speed}.ir。特别注意inc和dec操作会立即修改变量值然后在同一序列的后续动作中${fan_speed}就已经是新的值了。如果你的文件命名是speed1.ir,speed2.ir而变量初始为1那么inc后发送的就是speed2.ir逻辑正确。问题界面按钮太多操作不便。优化遵循“高频单键前置场景宏居中导航键置底或置边”的原则。将最常用的开关、音量键放在最容易按到的位置通常是屏幕左侧或上部。将“影院模式”、“离开模式”这种场景宏放在中间。将页面跳转、退出等导航按钮放在屏幕边缘。优化合理利用标签label进行视觉分区避免用户看花眼。问题Flipper按键手感较硬频繁操作累手。心得这不是软件能解决的。可以给Flipper的OK键贴一个软质贴片改善手感。更重要的是通过良好的场景宏设计减少日常操作中需要按下的次数。理想状态是开机一键场景关机一键场景日常调节才用单键。这个项目把Flipper Zero从一个“玩具”级别的遥控器变成了一个高度定制化的家庭自动化控制终端。它的魅力不在于替代了所有原装遥控器而在于它提供了一种可能性让你按照自己的思维逻辑和使用习惯重新定义控制界面的可能性。从简单的聚合到带变量的交互再到与外部系统的联动想象可玩性极高。