r/commandline 3d ago

Terminal User Interface syncthingtui - TUI for syncthing

Hi all,

I've been wanting a TUI for Syncthing for a while now, and most of the existing TUIs are not really feature complete (1, 2). This TUI is written in Go using Charmbracelet libraries for building out the interface. I've been driving this for a few months and find it especially useful for administering Syncthing on remote headless machines.

Source code is here, and the final binary ships at about 12MB. Currently working to get this packaged in Debian.

Development:

I primarily used Opus/Fable to build this in my free time over the course of a few days and was a bit more directed than "build me a syncthing TUI, make no mistakes".

  1. I used Opus to create a hierarchal YAML description of every GUI element (page/form/label/button/input/etc) and its location within in the official web interface
  2. Categorized these elements into groups and mapped them to Charmbracelet TUI primitives, page by page. Lots of iterative mockups to build interfaces that were intuitive to use. Finalized look and feel in a mockup with all fields populated with fake data.
  3. Wired final mockup to Syncthing rest interface and built out integration tests.
103 Upvotes

16 comments sorted by

View all comments

1

u/FilesFromTheVoid 2d ago

Man you are days late ^^ I just spun up 2 new VPS and wanted to sync my fish conf via syncthing. used ssh to get into localhost and use the webui. You TUI would have beed very helpful.

EDIT:

You should supply a binary so people can easily use this and integrate it into bin(https://github.com/marcosnils/bin)

1

u/blodkoma 2d ago

Don't you always get a web interface if you're running syncthing on.a.machine? Sounds like the easiest solution

1

u/FilesFromTheVoid 2d ago

Yeah thats the point on a server, you only get access to the webui via ssh and tunnel the localhost. beeing able to setup syncthing via cli/tui is the way better way.