Get started

Install

Get vivibe on your Mac or Linux computer and keep it up to date.

Requirements

WhatNeeded
MacApple Silicon (M1 or later), macOS 13.3 or later. There is no Intel build.
Linuxx86_64. Ubuntu 22.04 or later, Debian 12 or later, or another distribution with glibc 2.35 or later. A .deb for Debian and Ubuntu, an AppImage for the rest.
WindowsNot yet. It is coming.
AccountA vivibe account whose email is approved for the beta (join here).
DockerOnly for Simulate and Environment.
tmux 3.2+Optional. Lets terminal sessions survive quitting the app.

Install on a Mac

  1. Join the beta

    Ask to join on vivibe.net/beta with the email you will sign in with. We approve emails a few at a time.

  2. Download the DMG

    Once you are approved, we send you vivibe-macos-arm64.dmg, the newest stable build.

    To check it, shasum -a 256 vivibe-macos-arm64.dmg must match the checksum sent with it.

  3. Drag to Applications

    Open the DMG and drag vivibe.app into Applications.

  4. Open vivibe

    The app is signed with a Developer ID and notarized by Apple, so it opens without warnings.

    On first launch you see the privacy notice. It comes back only when the notice changes.

Install on Linux

  1. Join the beta

    The same as on a Mac: ask to join on vivibe.net/beta with the email you will sign in with.

  2. Download the package

    The approval email links to both: vivibe-linux-x64.deb for Debian and Ubuntu, vivibe-linux-x64.AppImage for any distribution.

    To check a download, get SHA256SUMS-linux-x64.txt into the same folder and run:

    bash
    sha256sum -c --ignore-missing SHA256SUMS-linux-x64.txt
  3. Install

    Debian and Ubuntu: apt also installs what the app needs (WebKitGTK 4.1, GTK 3).

    bash
    sudo apt install ./vivibe-linux-x64.deb

    AppImage: make it executable and run it.

    bash
    chmod +x vivibe-linux-x64.AppImage
    ./vivibe-linux-x64.AppImage
  4. Open vivibe

    Sign-in opens your default browser, so one must be installed. git is needed to read repositories; tmux and xclip (or wl-clipboard on Wayland) are optional, for terminal sessions that survive quitting and for pasting into the terminal.

Updates

vivibe checks for updates 15 seconds after launch, then every 6 hours, and downloads them in the background. When one is ready, a dot appears on the Settings button and Settings → General shows Restart · <version>.

Update checks send the app version, platform and a random install ID used for staged rollouts. Nothing else.

Uninstall

On a Mac, quit vivibe and move it to the Trash. To remove its data too, delete:

Local data (macOS)
~/Library/Application Support/com.vivibe.desktop/
~/.vivibe/

On Linux, run sudo apt remove vivibe, or delete the AppImage. Its data:

Local data (Linux)
~/.local/share/com.vivibe.desktop/
~/.config/com.vivibe.desktop/
~/.cache/com.vivibe.desktop/
~/.local/state/vivibe/
~/.vivibe/

Per-repo settings live in each repo's .vivibe/ folder. See Local files.