DHIVA LABS · LEARN

Appearance

Installing Dhiva Labs apps ​

Dhiva Labs apps are published in several places, and each app's own Install page says which ones it uses. This page explains how each kind of install works, so those pages can stay short.

Which channels does my app have?

Not every app is in every store. Open the app's guide from All apps and read its Install page for the exact names and commands.

Linux ​

Snap Store ​

A snap is a self-contained package that updates itself. Snap comes with Ubuntu and is available for most other distributions.

bash
sudo snap install apiworkbench

Replace apiworkbench with the snap name on the app's install page. To update everything now, and to remove an app:

bash
sudo snap refresh
bash
sudo snap remove apiworkbench

Snaps run in a sandbox. A confined snap can usually read and write files under your home folder and on removable media, but not everywhere on the disk. If an app cannot open a file, move the file into your home folder.

The Dhiva Labs PPA (Ubuntu and derivatives) ​

A PPA is an extra software source for apt. Add it once, and the apps then update with the rest of your system.

bash
sudo add-apt-repository ppa:dhiva-labs/apps
bash
sudo apt update

Then install an app by its package name, for example:

bash
sudo apt install discwriter

A .deb file (Debian, Ubuntu, Mint) ​

Download the .deb from the app's GitHub releases page, then install it with apt so that its dependencies come too:

bash
sudo apt install ./apiworkbench_1.4.0_amd64.deb

Choose amd64 for an ordinary Intel or AMD computer and arm64 for ARM machines. To check which you have:

bash
dpkg --print-architecture

A tarball ​

Some apps also ship a .tar.gz that runs on most distributions. Unpack it and run the program inside:

bash
tar -xzf ApiWorkbench-1.4.0-linux-x64.tar.gz

A tarball does not update itself and adds no menu entry. Prefer a snap, the PPA or a .deb when one exists.

Checking a download ​

Many releases include a .sha256 file next to each download. It lets you confirm the file arrived intact:

bash
sha256sum -c apiworkbench_1.4.0_amd64.deb.sha256

OK means the file matches.

Windows ​

Microsoft Store ​

Open the Microsoft Store, search for the app's name and select Get. Store apps update automatically.

A .zip from GitHub ​

Download the Windows .zip from the app's releases page, right-click it and choose Extract All, then run the .exe inside the extracted folder. Do not run it from inside the zip.

Windows may show a SmartScreen notice for a program it has not seen often. Check that the file came from the app's own releases page on github.com/Dhiva-Labs before you choose to run it.

The first time an app that listens on the network starts (Mock Studio's server, for example), Windows Firewall asks whether to allow it. Allow private networks if other devices on your Wi-Fi should reach it.

Android ​

An APK from GitHub ​

  1. On the phone, open the app's releases page and download the .apk file.

  2. Open the downloaded file. Android asks whether to allow your browser or file manager to install apps. Allow it for this install.

  3. Select Install.

An APK installed this way does not update itself. To update, download the newer APK and install it over the old one. Your data is kept.

Only install APKs from the app's own releases page.

Browser extensions ​

Extensions install from the Chrome Web Store or Firefox Add-ons. Follow the link on the app's install page and select Add to Chrome or Add to Firefox.

Where the downloads are ​

Every open-source Dhiva Labs app has a releases page on GitHub:

text
https://github.com/Dhiva-Labs/<app>/releases

The newest release is at the top, with its files listed under Assets. The app's install page links to it.

If something goes wrong ​

SymptomLikely cause and fix
snap: command not foundSnap is not installed. Install snapd with your package manager, or use the .deb
add-apt-repository: command not foundInstall it with sudo apt install software-properties-common
.deb fails with unmet dependenciesInstall with sudo apt install ./file.deb, not dpkg -i
"wrong architecture"You downloaded arm64 for an Intel or AMD computer, or the reverse
A snap cannot see a fileMove the file under your home folder
The app does not appear in the menuSign out and in again, or start it from a terminal by its name

Next steps ​