itd is a daemon that uses my infinitime library to interact with the PineTime smartwatch running InfiniTime.
Go to file
Arsen Musayelyan 271510d528 Allow automatic release to the AUR 2022-09-01 11:50:41 -07:00
api Allow API client to be made from connection 2022-05-07 21:23:42 -07:00
cmd Fix comment above goroutine code 2022-07-31 02:40:46 -07:00
translit Fix typo in code (Czeck -> Czech) 2022-04-16 10:15:55 -07:00
.gitignore Add GoReleaser config 2022-09-01 01:52:46 -07:00
.gitm.toml Add gitm for mirroring 2021-08-21 15:59:19 -07:00
.goreleaser.yaml Allow automatic release to the AUR 2022-09-01 11:50:41 -07:00
LICENSE Initial Commit 2021-08-21 01:19:49 -07:00
Makefile Remove GOFLAGS from Makefile as the go tool already looks at that variable 2022-07-22 10:36:19 -07:00
README.md Update CI badge 2022-09-01 03:14:05 -07:00
calls.go Create and propagate contexts wherever possible 2022-05-11 13:24:12 -07:00
config.go Add metrics collection via sqlite 2022-05-10 18:03:37 -07:00
dbus.go Create and propagate contexts wherever possible 2022-05-11 13:24:12 -07:00
go.mod Update infinitime library and bluetooth library (Fixes #22) 2022-08-19 14:05:30 -07:00
go.sum Update infinitime library and bluetooth library (Fixes #22) 2022-08-19 14:05:30 -07:00
itd.service Initial Commit 2021-08-21 01:19:49 -07:00
itd.toml Add metrics collection via sqlite 2022-05-10 18:03:37 -07:00
main.go Propagate context to lrpc 2022-05-12 17:14:34 -07:00
metrics.go Create and propagate contexts wherever possible 2022-05-11 13:24:12 -07:00
music.go Transliterate song metadata (Fixes #13) 2022-03-11 13:14:23 -08:00
notifs.go Create and propagate contexts wherever possible 2022-05-11 13:24:12 -07:00
socket.go Propagate context to lrpc 2022-05-12 17:14:34 -07:00
weather.go Create and propagate contexts wherever possible 2022-05-11 13:24:12 -07:00

README.md

ITD

InfiniTime Daemon

itd is a daemon that uses my infinitime library to interact with the PineTime running InfiniTime.

Build status Binary downloads AUR package


Features

  • Notification relay
  • Notification transliteration
  • Call Notifications (ModemManager)
  • Music control
  • Get info from watch (HRM, Battery level, Firmware version, Motion)
  • Set current time
  • Control socket
  • Firmware upgrades
  • Weather
  • BLE Filesystem

Socket

This daemon creates a UNIX socket at /tmp/itd/socket. It allows you to directly control the daemon and, by extension, the connected watch.

The socket uses my lrpc library for requests. This library accepts requests in msgpack, with the following format:

{"Receiver": "ITD", "Method": "Notify", "Arg": {"title": "title1", "body": "body1"}, "ID": "some-id-here"}

It will return a msgpack response, the format of which can be found here. The response will have the same ID as was sent in the request in order to allow the client to keep track of which request the response belongs to.


Transliteration

Since the PineTime does not have enough space to store all unicode glyphs, it only stores the ASCII space and Cyrillic. Therefore, this daemon can transliterate unsupported characters into supported ones. Since some languages have different transliterations, the transliterators to be used must be specified in the config. Here are the available transliterators:

  • eASCII
  • Scandinavian
  • German
  • Hebrew
  • Greek
  • Russian
  • Ukranian
  • Arabic
  • Farsi
  • Polish
  • Lithuanian
  • Estonian
  • Icelandic
  • Czech
  • French
  • Armenian
  • Korean
  • Chinese
  • Romanian
  • Emoji

Place the desired map names in an array as notifs.translit.use. They will be evaluated in order. You can also put custom transliterations in notifs.translit.custom. These take priority over any other maps. The notifs.translit config section should look like this:

[notifs.translit]
    use = ["eASCII", "Russian", "Emoji"]
    custom = [
        "test", "replaced"
    ]

itctl

This daemon comes with a binary called itctl which uses the socket to control the daemon from the command line. As such, it can be scripted using bash.

This is the itctl usage screen:

Control the itd daemon for InfiniTime smartwatches

Usage:
  itctl [flags]
  itctl [command]

Available Commands:
  firmware    Manage InfiniTime firmware
  get         Get information from InfiniTime
  help        Help about any command
  notify      Send notification to InfiniTime
  set         Set information on InfiniTime

Flags:
  -h, --help                 help for itctl
  -s, --socket-path string   Path to itd socket

Use "itctl [command] --help" for more information about a command.

itgui

In cmd/itgui, there is a gui frontend to the socket of itd. It uses the Fyne library for Go.

Compilation

Before compiling, certain prerequisites must be installed. These are listed on the following page: https://developer.fyne.io/started/#prerequisites

It can be compiled by running:

go build ./cmd/itgui

Cross-compilation

Due to the use of OpenGL, cross-compilation of itgui isn't as simple as that of itd and itctl. The following guide from the Fyne website should work for itgui: https://developer.fyne.io/started/cross-compiling.

Screenshots

Info tab

Motion tab

Notify tab

FS tab

FS mkdir

Time tab

Firmware tab

Upgrade in progress

Metrics tab


Installation

To install, install the go compiler and make. Usually, go is provided by a package either named go or golang, and make is usually provided by make. The go compiler must be version 1.17 or newer for various new reflect features.

To install, run

make && sudo make install

Starting

To start the daemon, run the following without root:

systemctl --user start itd

To autostart on login, run:

systemctl --user enable itd

Cross compiling

To cross compile, simply set the go environment variables. For example, for PinePhone, use:

make GOOS=linux GOARCH=arm64

This will compile itd and itctl for Linux aarch64 which is what runs on the PinePhone. This daemon only runs on Linux due to the library's dependencies (dbus, and bluez specifically).


Configuration

This daemon places a config file at /etc/itd.toml. This is the global config. itd will also look for a config at ~/.config/itd.toml.

Most of the time, the daemon does not need to be restarted for config changes to take effect.


Attribution

Location data from OpenStreetMap Nominatim, © OpenStreetMap contributors

Weather data from the Norwegian Meteorological Institute