Welcome Beta Testers!

Thank you for helping us test the new Linux app! A few things to know before you get started:

• This is beta software. You may run into bugs.
• Tell us what you find. Please report any issues, confusing steps, or general feedback by opening a support ticket. Mention that you're a Linux beta tester, and include your distro and version, your desktop environment (GNOME, KDE, etc), whether you use Wayland or X11, and the app you installed (ScreenKin or Best Accountability).
• The new app uses our new End-to-End Encryption. You'll need to turn it on for your account before the new app can be added. The steps are below.
• These instructions are a work in progress too. If a step doesn't match what you see on screen, let us know.

If you need to uninstall the beta build for any reason, use one of the following commands.

For ScreenKin:

curl -fsSL https://linux.truple.io/sk/uninstall.sh | sudo sh

For Best Accountability:

curl -fsSL https://linux.truple.io/ba/uninstall.sh | sudo sh

Upgrade Process

The Truple app is continuing its evolution into two separate apps:

• ScreenKin - App designed for parents to help monitor their children
• Best Accountability - App designed for individuals needing help overcoming porn and other online habits

The new Linux app was rebuilt from the ground up as a native Linux app. It is faster, more stable, install through your distro's package manager instead of an AppImage, keep themselves up to date automatically, and protect your data with our new End-to-End Encryption. Your existing account, subscription, and reports stay exactly the same and both apps work with your current Truple account and login.

Upgrading takes three steps:

1. Uninstall Truple
2. Enable new encryption on your Truple account
3. Install the new app

Supported versions of Linux

The new apps require:

• A 64 bit Intel/AMD (x86_64) or ARM (aarch64) processor
• systemd
• glibc 2.28 or newer
• A desktop session running either Wayland or X11

That covers most modern distros, including:

Not supported: distros that don't use systemd (Alpine, Devuan, Artix, Void with runit) and distros that use musl instead of glibc. If that's you, keep using the Truple app.

Not sure what you have? Run these in a terminal:

cat /etc/os-release
uname -m
ldd --version

Uninstall Truple

The account owner should do the following:

1. Go to the device settings page. Login with the subscribed Truple account if prompted to login.
2. Find the device you're upgrading, and click on it to expand its settings.
3. Check the delete checkbox
4. Click the Save button in the bottom right hand corner
5. On the device you're upgrading, find the Truple icon in the notification bar.
6. Click on the icon, then select Uninstall
7. Confirm to uninstall
8. Delete the Truple.AppImage file you originally downloaded.

Note: uninstalling will trigger a tamper alert and remove the device from your account. Once you install the new app a new device will appear on your report.

Enable New Encryption on Your Truple Account

The new apps can only be added to accounts that have our new End-to-End Encryption turned on. This only needs to be done once per account, by the account owner. It can be done from any computer or phone, it doesn't have to be the device you're upgrading.

1. Load the account page. Login with your subscribed account if you aren't already logged in.
2. Find the End-to-End Encryption section.
3. Click Set up a passkey.
4. Follow your browser's prompts to create the passkey. A passkey uses your device's screen lock (fingerprint, face, or PIN), so there's nothing to type or remember. Depending on your browser, you may be prompted twice: once to create the passkey and once to activate it.
5. If your device can't create a passkey, you'll be given a backup code instead. Download it or write it down and keep it somewhere safe, check I've saved my backup code, then click Continue.

Things to know:

• Use an up to date version of Chrome, Edge, or Safari on a phone or computer that has a screen lock. Passkeys aren't available in some browsers on Linux, so this step may be easier from your phone.
• Your existing E2EE passcode (now called Legacy Encryption) isn't going away. Your other devices still use it, so keep it written down.
• On your report, data protected with Legacy Encryption displays a 🔑 symbol and data protected with the new End-to-End Encryption displays a 🔒 symbol.

Install New App

Pick the app that best matches how you'll use it. Best Accountability is intended to be used by adults and ScreenKin intended for parents monitoring a child's or shard household device. Both capture the same screenshots and report to the same account. The difference is for compliance to rules governing apps intended for adults vs children.

Step 1: Run the install command

Open a terminal on the device you're upgrading and run the command for the app you chose.

ScreenKin - For Parents & Families

curl -fsSL https://linux.truple.io/sk/install.sh | sudo sh

Best Accountability - For Individuals

curl -fsSL https://linux.truple.io/ba/install.sh | sudo sh

The installer checks that your system is supported, downloads the latest version for your distro and processor, verifies it, and installs it using your package manager (apt, dnf, or zypper). On other distros it installs to /opt. The app is installed for every user on the device.

If curl isn't installed, install it first (for example sudo apt-get install curl).

Step 2: Add the device to your account

1. Open the app from your applications menu.
2. On the Add Device to Account screen, enter the subscribed account's email address and a name for this device.
3. Click Register Device.
4. The subscribed account owner then logs in to app.truple.io and approves the request to add the device.
5. Back in the app, click Check If Granted.
6. Wayland only: when your system asks for permission to capture the screen, make sure you grant it — if you deny it, getting the system to prompt again can be difficult.
7. When the application Dashboard comes up, make sure to enable Auto-Launch so that the app launches at startup and restarts if it crashes.

That's it! The app now runs in the background and starts automatically whenever a user logs in. Within a few minutes, check your report and you should see screenshots from the new device.

If the app says This account hasn't set up our new End-to-End Encryption yet, complete the Enable New Encryption section above, then click Register Device again.

GNOME users: GNOME doesn't show tray icons on its own. To see the app's icon near the clock, install the AppIndicator extension (Ubuntu includes it already). The app works without it; you can always open it from the applications menu.

If you experience any issues, please open a support ticket.