Docs menu
  1. Docs
  2. Get set up
  3. Install Rivet

Install Rivet

Download Rivet for Mac, Windows or Linux and open it for the first time.

  1. Go to rivet.mapped.com/download. The page picks a download for your computer; every other system and processor is listed underneath, each with its own link. A browser can't tell Apple silicon from Intel, or x64 from ARM, so check that the one it picked matches your computer:
    • Mac: in the Apple menu, choose About This Mac. A chip named Apple M1 or later is Apple silicon; Intel is Intel.
    • Windows: open Settings › System › About. System type says x64 or ARM.
    • Linux: run uname -m in a terminal. x86_64 is x64; aarch64 is ARM64.
  2. Open the file you downloaded:
    • Mac: open the .dmg and drag Mapped Rivet into Applications. Then open it from Applications or Launchpad.
    • Windows: run the installer and follow its steps. Rivet appears in the Start menu as Mapped Rivet.
    • Linux: the download is an AppImage, one file that is the whole app. Allow it to run in the file's properties, or run chmod +x on it, then open it.
  3. The first time it opens, Rivet shows its license agreement before anything else: read it and choose I Agree (Your first launch has more).
  4. The first time it opens, and after each update, Rivet plays a short greeting. Click anywhere, or press Esc, to skip it.

Updates

On a Mac, on Windows and on Linux with the AppImage, Rivet looks for a new version when it opens and every few hours after, and downloads it in the background. When one is ready it asks whether to restart now. Choose Later and it installs the next time you quit. It never asks while an app is being built. If an update changes the license agreement, Rivet shows it again the next time it opens, and you choose I Agree before you go on.

While an update is waiting, an Update button stays at the right of Rivet's title bar, and Settings › This computer shows Restart to update to and the new version beside Version. Press either to restart into the update at once; Rivet doesn't ask again. While an app is being built it doesn't restart, and says the update installs the next time you quit.

To look for one now, choose Mapped Rivet › Check for Updates… on a Mac, or Help › Check for Updates… on Windows and Linux. Rivet says whether you're up to date, starts downloading a newer version, or asks you to restart if one is already waiting. If this copy can't update itself, it says why.

On a Mac, Rivet can only update itself from Applications (or the Applications folder in your home folder). If you open it straight from the disk image, or from your Downloads folder, it says it can't update itself and offers Move to Applications. If someone else installed Rivet in Applications and your account can't make changes there, it says it can't update itself where it's installed: ask whoever installed it to update it, or download it again from rivet.mapped.com/download and put it in the Applications folder in your home folder.

A Mac copy installed before Mac updates started doesn't look for them: download it once more from rivet.mapped.com/download and replace the one in Applications.

On Linux with a .deb, .rpm, pacman package, Flatpak or .tar.gz, Rivet does not update itself: download the new version from rivet.mapped.com/download and install it the same way as the first one. To see which version you have, open Help › About Mapped Rivet (on a Mac, Mapped Rivet › About Mapped Rivet).

Next: your first launch.