Duple Documentation and Tutorials

We are distributing our app using Homebrew.

For those who don't know what it is, Homebrew is a package manager for macOS. It simplifies downloading, installing and updating applications that are not on the Mac App Store.

If you don't want to use Homebrew, you can find instructions to install the app manually at the end of this document.

You need at least macOS Sierra (10.12) to run DupleCLI.

1. Install Homebrew

To install Homebrew, run this command:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Opt out of the analytics program for more privacy (more info here):

brew analytics off

2. Add Duple's tap:

Taps are third parties applications repositories, adding them gives you access to more software using Homebrew. Add Duple's tap using:

brew tap duple/homebrew-duple https://git.duple.io/duple/homebrew-duple

3. Install DupleCLI

To automatically install DupleCLI (and its dependencies) use:

brew install duplecli-beta

If you want DupleCLI to start at login, enable it using:

brew services start duplecli-beta

You're good to go! You can now use DupleCLI in your terminal with duplecli.

Update DupleCLI

To update all the applications installed using Homebrew (including DupleCLI), run the command:

brew update && brew upgrade

To only update DupleCLI:

brew update && brew upgrade duplecli-beta

Manual Installation

  • Install DupleCLI's dependencies (libssh2, openssl and python 2.7) on your macOS. Normally openssl comes already pre-installed.
  • Download the app from the download page.
  • Extract the content of the package using tar -xzvf duplecli-x86_64.tar.gz.
  • Create the library link using: sudo ln -s /path/to/duplecli/libduple.dylib /usr/local/lib/libduple.dylib.
  • Create the libssl library dependency link using: sudo ln -s /usr/lib/libssl.dylib /usr/local/lib/libssl.1.0.0.dylib.
  • Create the libcrypto library dependency link using: sudo ln -s /usr/lib/libcrypto.dylib /usr/local/lib/libcrypto.1.0.0.dylib.
  • Create the app link using sudo ln -s /path/to/duplecli/duplecli.py /usr/local/bin/duplecli.
  • Set duplecli.py executable chmod +x /path/to/duplecli/duplecli.py.
  • If you want DupleCLI to start at login, link the launchd file ln -s /path/to/duplecli/com.duplecli.app.plist ~/Library/LaunchAgents/com.duplecli.app.plist

You're good to go! You can now use DupleCLI in your terminal with duplecli.