Overview of CyThrough

Documentation / Contents - CyThrough

• Overview of CyThrough
  • What It Is
  • What It Is Not
  • The Three Programs
  • In This Book
• Setting Up
  • What You Need
  • Build and Install
  • Setup With the GUI
  • Setup Without the GUI
  • Lab Auth File
  • Hardware Display Attach
  • Check That It Works
  • Common Mistakes
• Using CyThrough
  • Connect and Catalog
  • Launch and Running
  • Materialize On Desktop
  • Published Apps Menu
  • Quality and Encryption
  • Stopping Apps and the Daemon
• Command Line
  • cythrough Viewer
  • cythroughd Daemon
  • cythrough-prefs Launcher
  • Password and Knock Order
  • Environment
• How the Protocol Works
  • Framing
  • Channels
  • HELLO and Auth
  • Catalog and Launch
  • Pixels and Input
  • Capabilities and Codecs
  • Manager and Backend
• Keys and Shortcuts
• Files and Paths
  • Client Conf
  • Daemon Conf
  • Catalog Cache
  • Desktop Launchers
• Copyright

CyThrough

CyThrough publishes X11 applications from a Linux, BSD, or IRIX host and shows them as native windows on this desk. You pick an app from a catalog, it runs on the remote box, and its windows land next to your local Cy* apps, framed by this window manager.

Open this book from Help Books in the Contents pane as "CyThrough", or:

cyhelp --book CyThrough --topic overview

The page most people need first is Setting Up. Day-to-day use is in Using CyThrough. Every flag is in Command Line.

What It Is

• An xpra work-alike for the Cyanotype house: publish apps, not a whole nested desktop.
• A tile-damage protocol over TCP (magic 'T'), with optional SPA knock and AEAD session crypto.
• Three programs: a Motif launcher, a skinny viewer, and a personal daemon.
• First-class on IRIX as both server and client (C99, BSD-2-Clause).

What It Is Not

• Not a nested remote desktop, not VNC, not Wayland, not a Windows client.
• Not CyBeam (the abandoned Windows agent). That tree is archive only.
• Not adoption of apps already running on someone else's glass. v1 publish means argv the daemon execs for you.
• There is no Motif face on the daemon. You start cythroughd yourself (or from the launcher Server controls).

The Three Programs

cythrough-prefs   Motif launcher and settings (Connect, catalog, Running)
cythrough         skinny viewer: decode tiles, blit, forward input
cythroughd        personal daemon: auth, catalog, dummy-X or hardware-X

cythrough and cythroughd are CLI tools (no Motif). cythrough-prefs needs Blueprint Motif. Encryption is on by default. A knock secret is a passphrase (optional on a quiet LAN). Passwords in the address book are obfuscated, not stored in the clear.

In This Book

• Setting Up -- GUI and CLI paths, lab auth, hardware attach
• Using CyThrough -- catalog, Running, Materialize, quality
• Command Line -- every option for viewer, daemon, and prefs
• How the Protocol Works -- framing, channels, HELLO, tiles
• Keys and Shortcuts
• Files and Paths

Related On This Desktop

• In the Blueprint book, open Settings Books (topic settings-books). CyThrough sits near the top with the other desktop programs.
• Toolchest can carry a CyThrough menu entry from the shipped share menu.
• Open Help Books in the Contents pane and pick CyThrough, or:

cyhelp --book CyThrough --topic overview
cyhelp --book CyThrough --topic setup