Fix a CLI API

[Jegp]

The current command-line interface is in a state of flux. We should consolidate on an API that is both simple and easy to use while supporting the stream-based API (with inputs, filters, outputs - including renderers).

User stories

• Command-line user, "simple routing"'. Something very "file-based" running on laptops (analog: FFMPEG / imagemagick)
  • Going from file -> file
  • Rendering files to videos
• Streaming data from A -> B (gstreamer)
  • From file -> UDP
  • From camera -> RDP
• Check recording is working (immediate visualization)
  • No strict guarantees
• Real-time processing of GPU frames
  • Minimal event processing before passing GPU frames on
• Record many short recordings and (20-30)
  • First pass: render them all once in real-time and identify "interesting regions" as configuration setups
    • E. g. "narrow down to 15-17 seconds at .5x speed)
  • Re-render with new configurations - inspiration: Charidotella
• Exploratory statistics
  • Render event-time plots
  • Render time-averaged color pictures
  • Render spectograms

[Jegp]

Possible ideas for CLI APIs

I/O centric: faery input file x.aedat4 filter time_slice filter denoise output file y.mp4 I/O centric 2: faery [--input file x.aedat4] [! time time_slice x] [--output file y.mp4] Task centric: faery render -i x.aedat4 -o y.mp4 Object centric: faery 'open_camera(...).filter(...)'

Alternative commands

Default: faery [--input file x.aedat4] [! time time_slice x] [--output file y.mp4] Colormaps: faery colormaps ... Generate template script: faery template ...