FlooCatchLinux

Linux receiver app for the FlooGoo FMA120 Auracast receiver.

This project is a separate Linux-native implementation next to FlooCatchMac. It reuses the receiver protocol and state-machine behavior, but uses Linux-native desktop/runtime choices:

• C++
• Qt 6 Widgets
• QSerialPort for CDC serial transport
• dedicated Linux audio backend abstraction

Status

Current implementation includes:

• Auracast parser ported from the macOS app
• serial session logic for scanning, sync selection, and PIN handling
• Qt desktop UI
• PipeWire-based Linux audio loop integration
• installable desktop launcher and icon metadata for .deb / .rpm

Build

Ubuntu 24 / Linux Mint 22.x

Install the build dependencies:

sudo apt update
sudo apt install build-essential cmake qt6-base-dev qt6-serialport-dev

Build:

cmake -S . -B build
cmake --build build

Run:

./build/FlooCatchLinux

Ubuntu 22.04 / Linux Mint 21.x

Linux Mint 21.x is the Ubuntu 22.04-based Mint series. On these systems, install:

sudo apt update
sudo apt install build-essential cmake qt6-base-dev qt6-serialport-dev

Then build and run:

cmake -S . -B build
cmake --build build
./build/FlooCatchLinux

If you want to test a specific UI language without changing the whole desktop session:

LANG=ja_JP.UTF-8 ./build/FlooCatchLinux
LANG=zh_CN.UTF-8 ./build/FlooCatchLinux
LANG=fr_FR.UTF-8 ./build/FlooCatchLinux

Runtime Notes

• pw-loopback, pw-cli, and wpctl should be available on the target Linux system for audio loopback and device routing.
• The FMA120 should appear as a serial device with identifying metadata containing FMA120, FlooGoo, or Flairmesh.
• On Ubuntu and Mint, users may need the correct USB/serial device permissions depending on their system configuration.

Packaging Direction

The intended release targets are:

• .deb
• .rpm