Install Arto

Get started with Arto in seconds. Choose your preferred installation method.

HomebrewRecommended

The easiest way to install Arto on macOS. Homebrew handles installation and updates automatically.

Terminal

brew install --cask arto-app/tap/arto

Gatekeeper Note

Since Arto is not notarized yet, you may need to allow it in System Settings → Privacy & Security after first launch, or run:

Terminal

xattr -dr com.apple.quarantine /Applications/Arto.app

Nix

For Nix users, Arto can be run directly from the flake or added to your configuration.

Try it out

Terminal

nix run github:arto-app/Arto

Add to your flake

flake.nix

{
  inputs = {
    arto.url = "github:arto-app/Arto";
  };

  outputs = { self, nixpkgs, arto, ... }: {
    # nix-darwin
    darwinConfigurations.your-host = darwin.lib.darwinSystem {
      modules = [
        {
          environment.systemPackages = [
            arto.packages.${system}.default
          ];
        }
      ];
    };

    # home-manager
    homeConfigurations.your-user = home-manager.lib.homeManagerConfiguration {
      modules = [
        {
          home.packages = [
            arto.packages.${system}.default
          ];
        }
      ];
    };
  };
}

Build from Source

For developers who want to build Arto from source or contribute to development.

Prerequisites

Rust toolchainNode.js & pnpmmacOS

Clone and build

Terminal

git clone https://github.com/arto-app/Arto.git
cd Arto
pnpm install
cargo build --release

Vim / Neovim Plugin

Open Markdown files in Arto directly from Vim or Neovim with the official arto.vim plugin.

vim-plug

~/.vimrc

Plug 'arto-app/arto.vim'

lazy.nvim

lua

{ 'arto-app/arto.vim' }

Requirements

Requires Vim 9.0+ or Neovim 0.10+, and Arto v0.15.0+ installed at /Applications/Arto.app.

Emacs Package

Open Markdown files in Arto directly from Emacs with the official arto.el package.

package-vc (Emacs 29+)

Emacs

(package-vc-install "https://github.com/arto-app/arto.el")

use-package with vc (Emacs 30+)

init.el

(use-package arto
  :vc (:url "https://github.com/arto-app/arto.el"))

Manual

init.el

(add-to-list 'load-path "/path/to/arto.el")
(require 'arto)

Requirements

Requires Emacs 27.1+ and Arto v0.15.0+ installed at /Applications/Arto.app.

System Requirements

macOS 11.0+Apple Silicon

Cross-Platform Support

Arto is currently macOS-only, but cross-platform support (Windows, Linux) is planned for future releases.