Skip to main content
Tuple for Linux is currently in alpha and under active development. The client is primarily command-line driven. To install, visit the Linux install page for the latest download command and architecture options. Join the Slack channel to provide feedback, report bugs, and ask questions.

Current feature set

The Tuple client on Linux is extremely barebones at the moment. We’ll be working hard to flesh it out in the coming weeks — your patience is appreciated!

What works

  • Logging in and running Tuple as a daemon — you’ll appear available for your contacts / teammates
  • Receiving an incoming direct call
  • Starting a call
  • Joining a call via a URL
  • Hearing (and being heard by) others using the system default audio device
  • Viewing a shared screen
  • Sharing your own screen (on both X11 and Wayland)
  • Viewing drawing annotations on a shared screen
  • Remotely controlling someone else’s screen
  • Drawing on the shared screen

Not yet implemented

  • Being remotely controlled while sharing
  • Anti-aliasing on the shared screen (things look very “crunchy” at the moment)
  • Viewing text or highlight click annotations on the shared screen
  • Changing audio devices
  • Viewing your contact list
  • Initiating direct calls
  • Sharing or viewing webcams

Commands

CommandDescription
tuple loginInitiates the login process. Outputs a URL to log in via the web; the last step emits an authorization code to be used in tuple auth.
tuple auth $AUTH_CODEAuthorizes the local Tuple client. Takes the code emitted via the web login flow as its only parameter.
tuple newStarts a new call and automatically adds you as a participant. Prints the URL of the call to the console so you can share it with others.
tuple endEnds the current call if it’s just you and one other person; leaves the call if others are still on it (or you’re in a room).
tuple join $CALL_URLJoins a call that’s in progress (or a room). Takes the URL of the call or room as its only parameter.
tuple shareStarts sharing your entire viewable display — not just one monitor.
tuple unshareStops sharing your screen.
tuple onStarts running the Tuple daemon. The daemon also starts automatically when most other commands are run (including auth, new, and join).
tuple offStops the Tuple daemon.
tuple uiDisplays a simple debugging UI.
tuple settingsLists all settings.
tuple set $name $valueSets the setting named $name to the given $value.

Settings

SettingTypeDescription
host-overlayboolEnables the “host overlay”, which is where annotations are drawn. Transparency doesn’t work correctly with certain window managers, which can cause this window to render incorrectly. Use this setting to disable it if needed.
Tuple runs fc-match sans-serif:fontformat=TrueType to find your system’s “sans-serif” font.

Logs

Tuple logs to:
$XDG_DATA_HOME/tuple/0/log.txt
If the $XDG_DATA_HOME environment variable is not set, logs are written to:
$HOME/.local/share/tuple/0/log.txt
These are useful to include in any bug reports.