1. First run#
In this chapter you install mpmux, open it, and use it as your everyday terminal.
Install#
| Platform | How |
|---|---|
| Arch Linux | Use the signed pacman repository. See Install on Arch Linux. |
| Ubuntu 22.04+, Debian 12+ | Use the signed apt repository. See Installation. |
| Other Linux | Build from source; see Building. |
| macOS 11+ | Download the app from https://mightypainting.dev/mpmux/, signed and notarized by Apple. Unzip it and move mpmux.app to Applications. |
| Android | Download the APK from https://mightypainting.dev/mpmux/. The app updates itself. |
| iOS | Not released yet. |
Open mpmux#
Run:
mpmux
A window opens with one shell. mpmux reads your normal shell setup, so your prompt, aliases, and tools work as before.
What you get at once#
- GPU rendering. mpmux draws the terminal on the GPU with Ghostty's terminal engine. Full-screen programs such as editors and monitors show correctly and scroll smoothly.
- Correct glyphs. Nerd Font icons, box drawing, and emoji show without extra font setup. mpmux brings the fonts it needs.
- Images in the terminal. Programs that use the Kitty graphics protocol
show pictures inline. Try
chafa -f kitty picture.png.
Copy and paste#
| Action | Keys |
|---|---|
| Copy the selection | Ctrl+Shift+C (macOS: Cmd+C) |
| Paste | Ctrl+Shift+V (macOS: Cmd+V) |
| Make the text larger | Ctrl+= |
| Make the text smaller | Ctrl+- |
Select text with the mouse. Programs that use the mouse themselves, such as some editors, get the mouse events instead. Hold Shift to select text in those programs.
Find any action: the command palette#
Press Ctrl+Shift+P. Type part of an action name, for example split, and
press Enter. The palette lists every action with its shortcut, so you can
learn the shortcuts as you go.
Next#
Chapter 2 shows how to arrange shells in tabs and splits.