Support

Frequently asked questions

• What file formats does Refract support?

  Refract currently opens:

  • CSV
  • Parquet
  • Arrow IPC (file)
  • Audio (WAV, CAF)

  More formats may be added in future releases.

• How do I connect to a live stream?

  Use File → Open Connection… (⌘⇧O) to open the connection sheet.

  Transports:

  • TCP
  • Serial port
  • BLE
  • USB HID
  • RefractIO

  Then:

  • Choose a transport and configure connection settings
  • Configure framing and decoding
  • Connect
  • Optionally save a preset so you can reconnect in one click

  Decoding options include delimited text (CSV/TSV), fixed-frame binary with typed fields (float, int, etc.), and Arrow IPC.

• What keyboard shortcuts are available?

  Common shortcuts:

  ⌘O	Open File
  ⌘⇧O	Open Connection
  ⌘L	Follow Live
  ⌘0	Reset X Zoom
  ⌘R	Reset All Zoom
  ⌘+ / ⌘−	Zoom In / Out
  ⌘[ / ⌘]	Scrub Left / Right
  ⌘⇧N	Add New Track

• Can I use Refract with my own data pipeline?

  Yes.

  For live streams, any system that sends data over TCP, serial, BLE, or HID can connect to Refract.

  • For structured columnar data, use Arrow IPC over TCP (see stream_arrow_sample.py for a Python/PyArrow example).
  • For simpler protocols, configure text or binary decoding.

  For files, open CSV, Parquet, or Arrow IPC directly.

• What framing and decoding options are available for streams?

  Framing determines how Refract splits raw bytes into messages:

  • Delimiter-based (e.g. CR-LF)
  • Length-prefixed (1/2/4-byte header)
  • Fixed-size frames
  • Sync-pattern alignment
  • Self-framed Arrow IPC

  Decoding interprets each frame:

  • Delimited text (CSV/TSV with configurable separator)
  • Fixed-frame binary (define fields by type, size, and byte order)
  • Arrow IPC

  For binary, supported field types include float32, float64, int8–int64, uint8–uint64, and padding bytes.

• Where is my data stored?

  Refract reads opened files from the locations you choose.

  If you enable persistence for a stream connection, data is stored locally in your Application Support folder under Refract.

  No data is sent to our servers.

Getting more help

If you don’t find what you need here, please use the contact form to send us a message. Include your Mac model and macOS version, and describe the issue or question so we can respond as quickly as possible.

For privacy-related requests, please review our Privacy Policy and select “Privacy inquiry” in the contact form.