# Tetramote

Control your computer from your phone. Tetramote shows your Mac, Windows or Linux screen on your phone, with its sound, and sends your taps and typing back. Scan the computer's code with the app, or open its link in any browser. There's no account to make and no Tetramote server in between.

## Pair once, then connect from anywhere

1. **Install Tetramote on the computer.** Its icon is in the menu bar on a Mac and in the system tray on Windows and Linux. Click it to show a pairing code.
2. **Scan the code with your phone.** Or click Copy link on the computer and paste it into the phone. The code and link stay the same until you make a new one.
3. **Connect again without a code.** Your phone and the computer now have each other's keys, so later connections need no code. They work on the same Wi-Fi or across the internet.

## What it does

- **Screen and sound.** The screen streams as H.264 from the computer's hardware encoder where it has one, and system audio streams as Opus. Turn on connection details in Settings to see whether the connection is direct and how long a round trip takes.
- **Trackpad or direct touch.** Drag to move the pointer, tap to click, tap with two fingers to right-click, and drag two fingers to scroll. To drag a window, hold your finger still until the phone taps back, then drag. Or switch to direct touch and tap the screen itself, pinching to zoom in.
- **Modifier and arrow keys.** A row above the phone's keyboard has Esc, Tab, Command, Option, Control, Shift and the arrow keys. On Windows and Linux, Command and Control press Ctrl and Option presses Alt.
- **Clipboard and displays.** Send your phone's clipboard to the computer, or copy the computer's clipboard to your phone. With more than one monitor, pick which one to show.
- **Full screen.** The computer's screen fills the display, and the controls float on top and hide after a few seconds. Tap with three fingers to bring them back.
- **From a browser or another computer.** Open a computer's link in any browser and its screen opens in the tab, with mouse, keyboard, touch and sound. The desktop app controls other computers too, in a window.

## There's no account and no Tetramote server

Tetramote connects your devices with [iroh](https://iroh.computer). Every connection is end-to-end encrypted QUIC and goes direct whenever the networks allow it. When they don't, traffic passes through n0's public relays, or a relay you run yourself, which see only encrypted packets.

- The link carries a 128-bit secret after the #, which browsers never send to a web server. Make a new link and the old one stops working.
- Each computer keeps its key in the system keychain.
- Remove a device in the computer's menu and its session ends right away.
- The apps and the protocol are open source under the MIT license.

## Download

- **macOS.** The app runs on Apple silicon and Intel Macs. It isn't notarized yet, so the first time you open it, allow it in System Settings › Privacy & Security. It needs Screen Recording and Accessibility permission to share the screen and take input.
- **Windows.** Needs Windows 10 or later. Tetramote uses the GPU's H.264 encoder when there is one.
- **Linux.** Needs GNOME or KDE Plasma with PipeWire, on Wayland or X11. It also needs glibc 2.39 or newer, which means Ubuntu 24.04, Debian 13, Fedora 40 or later.
- **iPhone.** Get Tetramote for iPhone on the App Store. It's made for the iPhone Duo and works on every iPhone with iOS 17 or later. https://apps.apple.com/app/tetramote/id6837369826
- **Android.** The Android app isn't on Google Play yet. Until it is, open the computer's link in your phone's browser, or build the app from the source on GitHub.

Downloads: https://github.com/tetramo-labs/tetramote/releases/latest
Source: https://github.com/tetramo-labs/tetramote

## Questions

### Does it cost anything?

No. Tetramote is free, and its code is open source under the MIT license.

### Do I need an account?

No. The computer shows a code, your phone scans it once, and from then on the two identify each other by their keys.

### Does it work away from home?

Yes. Your phone reaches the computer over the internet, directly when the networks allow it and through an encrypted relay when they don't. The computer needs to be on with Tetramote running.

### Does my screen pass through your servers?

No. There is no Tetramote server. When a relay is needed, it forwards packets it can't read. The relays belong to n0, the team behind iroh, and you can set your own in the phone's settings.

### Where do I get the phone app?

Get Tetramote for iPhone on the App Store. It's made for the iPhone Duo and works on every iPhone with iOS 17 or later. The Android app isn't on Google Play yet. Until it is, open the computer's link in your phone's browser, or build the app from the source on GitHub.

### Can I use it without installing anything?

The computer you share needs the desktop app. The device you control it from needs nothing installed. Open the computer's link in Chrome, Edge, Safari or Firefox and the screen opens in that tab. Browsers can't connect directly, so they always go through an encrypted relay.

### Which Linux desktops work?

GNOME and KDE Plasma, on Wayland or X11. Tetramote shares the screen and takes input through the desktop portal, and wlroots compositors such as Sway don't offer remote input there yet.
