itd is a daemon that uses my infinitime library to interact with the PineTime snartwatch running InfiniTime.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Arsen Musayelyan 19caa3ee83 Add gitm for mirroring 10 months ago
cmd/itctl Change recoverable errors to warn log level to stop shell from exiting 10 months ago
internal/types Initial Commit 10 months ago
.gitignore Initial Commit 10 months ago
.gitm.toml Add gitm for mirroring 10 months ago
LICENSE Initial Commit 10 months ago
Makefile Initial Commit 10 months ago
README.md Specify minimum go version in readme 10 months ago
go.mod Add interactive mode to itctl 10 months ago
go.sum Add interactive mode to itctl 10 months ago
itd.service Initial Commit 10 months ago
itd.toml Initial Commit 10 months ago
main.go Prioritize config in home directory over /etc 10 months ago
music.go Initial Commit 10 months ago
notifs.go Initial Commit 10 months ago
socket.go Initial Commit 10 months ago

README.md

ITD

InfiniTime Daemon

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


Features

  • Notification relay
  • Music control
  • Get info from watch (HRM, Battery level, Firmware version)
  • Set current time
  • Control socket
  • Firmware upgrades

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 accepts JSON requests. For example, sending a notification looks like this:

{"type": "notify", "data": {"title": "title1", "body": "body1"}}

It will return a JSON response. A response can have 3 fields: error, msg, and value. Error is a boolean that signals whether an error was returned. If error is true, the msg field will contain the error. Value can contain any data and depends on what the request was.

The various request types and their data requirements can be seen in internal/types. I can make separate docs for it if I get enough requests.


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 [command]

Available Commands:
  completion  generate the autocompletion script for the specified shell
  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

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

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.16 or newer for the io/fs module.

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, bluez, and playerctl 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.