Installation & Usage

There are 2 easy ways to install the Senses software for your Smart Mirror; you can use Curl for a manual installation or use the Senses CLI. For both installations please follow the prerequisites first.

Prerequisites

  1. Install NodeJS

For more information on installing Node.js, see nodejs.orgopen in new window. If you are unsure what version of Node.js runs on your system, run node -v in a terminal window.

Installation with Senses CLI

Before installing the full Senses - Smart Mirror software make sure you have all prerequisites installed and ready!

First we will install the Senses CLI with NPM and then use CLI commands to further download the software.

Installation steps

  1. Install Senses CLI (globally)
npm install -g @senses-mirror/senses-cli
1
  1. Install Senses - Software
senses install
1
  1. If all good you will see:
All done. Senses - Smart Mirror successfully installed.
1

The Senses - Smart Mirror software is now installed. You will see a senses-smartmirror folder.

Installation with Curl

bash -c  "$(curl -sL https://raw.githubusercontent.com/senses-smart-mirror/senses-scripts/main/lib/raspberry-pi-install.sh)"
1

Starting Senses with NPM

Senses - Smart Mirror software can be started from within the senses-smartmirror with the following command:

npm run start
1

Starting Senses with the CLI

You can also use the Senses - ClI to start the Senses software. Run the following command inside the senses-smartmirror folder.

senses run
1

Starting Senses with PM2.

Step 1: Follow the installation guide from PM2open in new window.

Step 2: Change directory to the parent of the senses-smartmirror and create a pm2.json file.

Step 3: Paste the following JSON inside the pm2.json file

{
    "apps": [
        {
            "name": "Senses - Smart Mirror",
            "script": "npm",
            "cwd": "./senses-smartmirror",
	          "autorestart": false,
            "args" : "start"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11

Step 4: Start PM2 with:

pm2 start pm2.json
1

Step 5 (optional): if you want to save the current PM2 configuration you can use the following command. This will remember the configuration when the operation system restarts.

pm2 save
1

Next Step

The next step to Configure the Smart Mirror

Latest Version

Detailed release notes for each version are available on GitHubopen in new window.