relatica/install.md

3.0 KiB

Relatica Installation Instructions

NOTE: Relatica is in an early beta status. Use at own risk. For more information about the current beta testing program see the program's notes page.

Latest Binaries:

Mobile

Android

  1. Configure your phone to allow installing APKs through the browser. See this LifeWire article for instructions.
  2. Download the latest Android version (see above for versions).
  3. Follow the prompts to initiate installation.

iPhone/iPad

  1. Contact the development team for access to the TestFlight program.
  2. Install the TestFlight application from the Apple Store
  3. You will receive an invitation email that you must open on a phone or tablet
  4. Open the TestFlight app to see the Relatica app ready for testing
  5. Subsequent releases during the beta program will be pushed to TestFlight on each build.

Desktop

macOS

  1. Download the latest version (see above)
  2. Unzip the archive.
  3. Copy to wherever you want to store the Application (Applications folder is the usual place)

Note: that the username/password are stored in macOS's keychain. You will need to provide a password to this when you use the app for the first time. If you select "Always Allow" then you should only be prompted for it if there is a major application change. If you selecte "Always" you will be prompted again. The system does not work without the storage mechanism at this time.

Linux

For Linux development be sure that libsecret-1-dev and libjsoncpp-dev are installed on the machine. For running only make sure the non-dev versions are...

  1. Install libsecret and libjsoncpp from your system's package manager.
  2. Download the latest version (see above)
  3. Unzip the archive.
  4. Copy to wherever you want to store the applications

Note #1: At this time the library dependencies on libsecret and libjsoncpp are a bit finicky. The build definitely works on Ubuntu 22 or Linux distributions built on Ubuntu 22. Testing on other distros hasn't happened yet. Please report results back and we will try to provide builds for other distros as they are needed.

Note #2: The app uses Linux's secret storage mechanism. Under testing under Cinnamon the access to the storage is reset whenever the user logs out. You therefore will be prompted for the password to the secret storage the first time you run the application after logging in or rebooting.

Windows