Everything here is built from source. There are no tagged binary releases for the apps or for anneal yet, and tie’s releases are source tags. That is deliberate: the projects are moving, and a binary built from the commit you are reading is more honest than a stale download.
Requirements
| Project | Needs |
|---|---|
| tie | Go 1.27.2+, Linux for FUSE, fusermount3, optionally Docker |
| the apps | Go 1.27.2+, CGO, X11/Wayland + OpenGL, libmpv, PipeWire (tie-audio), libmtp (tie-fm, Linux) |
| anneal | Go 1.27.2+, Fyne’s C dependencies for the GUI; the headless CLI and server need no GUI libs |
On a Debian/Ubuntu system the Fyne and media packages are roughly:
sudo apt install build-essential pkg-config libgl1-mesa-dev \
xorg-dev libxkbcommon-dev libwayland-dev \
libmpv-dev libpipewire-0.3-dev libmtp-devThe exact package names differ by distribution; the Fyne getting-started page and each project’s README have the current list.
git clone https://github.com/uidbz/tie
cd tie
make build # dist/
make install # client to ~/.local/bin
sudo make install-server # services, /etc/tie, /var/lib/tieDocker:
docker build -t tie .
docker run -d --name tie -p 1161:1161 -p 1162:1162 -v tie-data:/data tieGentoo: the overlay and ebuilds are in contrib/gentoo.
Verify the install
tie version
tie conf show
anneal-headless -htie version prints the client and the versions of the configured triplestore
and filehosts, which is the quickest way to catch a config pointing at the wrong
place.
Platforms
| Linux | Windows | macOS | Android | |
|---|---|---|---|---|
| tie (FUSE mount) | ✓ | SMB client | SMB client | — |
| tie-fm | ✓ | ✓ | ✓ | — |
| tie-audio | ✓ | ✓ | ✓ | ✓ |
| tie-view | ✓ | ✓ | ✓ | ✓ |
| imgview | ✓ | ✓ | ✓ | ✓ |
| tie-browser | ✓ | ✓ | ✓ | — |
| anneal | ✓ (GUI) | headless | headless | — |
The FUSE mount is Linux-only. The same tree is available on Windows and macOS
through tie-smb. tie-fm’s device browsing (USB, MTP) is Linux-only.
A first run in 60 seconds
The quickest end-to-end test is tie’s test environment:
cd tie/test-env
./build.sh && ./start.sh && ./seed.sh
./mount-db.sh
ls mnt/query/vacationThen point an app at the same server (ports 2161/2162, defaultuser /
defaultpassword). The apps’ quickstart has the config.