Skip to content

Instantly share code, notes, and snippets.

@dasantonym
Last active March 2, 2021 21:35
Show Gist options
  • Save dasantonym/9ad4e9b1b12eefad5f181b0502203579 to your computer and use it in GitHub Desktop.
Save dasantonym/9ad4e9b1b12eefad5f181b0502203579 to your computer and use it in GitHub Desktop.
LIGNAℓ How-To

LIGNAℓ How-To

This document describes usage instructions for a Scripted Messaging System.

The source code can be found at github.com/nrvdwrf/lignal.

Install

Download app(s) from files.hyper.fail/ligna/index.html.

Or use the QR-Code:

QRCode

Using the mobile app

The app has "secret" functionality in the chat:

cmd:clear    Deletes all messages currently stored on the device (reset)
cmd:record   Opens the screen for recording markers
cmd:track    Control functionality for location tracking

Recording locations

1. Record markers in the mobile app

In the mobile app, navigate to the chat and enter the following to get to the recording screen:

cmd:record

# If you are using autocorrect, this is also valid:
Cmd: record

Start a recording, set markers as appropriate, then stop the recording.

There should now be a file name like ligna_log_12321334334.json under the top-level /sdcard directory.

Download the file to your computer.

2. Add locations in desktop app

In the desktop app (Mac or Windows), either create a new Set or click the edit-icon for an existing.

Then navigate to the Locations tab and click on Import. Select your recorded file and the markers should be added to the locations list. Now save the Set.

3. Attach content to the location markers

Also in the desktop app, navigate to the Content tab and click on add.

Set a type for content that is to be associated with this marker (e.g. Text for a simple text message). Fill in the form and add the content item.

Now go back to the Locations tab and open the select drop-down for a specific marker, then choose your content item.

Important: Remember to set the radius on the marker as well!

4. Upload the set to the mobile app

Upload manually

On the overview page for the Sets, click the download icon for a particular set. This will create a folder at the target location named lignal.

Use a file transfer tool to store it on your phone under /sdcard.

Upload using ADB

You can conveniently upload your sets directly from the desktop app via ADB. To use this feature, you need to install Android Studio, then allow USB-Debugging on the phone.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment