INFINOTED(1)

📦 version 0.7.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 INFINOTED(1) 💖

okay bestie, welcome to the infinoted manual page — that's section 1 of the manual, "User Commands", and it's literally the whole vibe. sit down, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

infinoted — a dedicated server for the infinote protocol (like, for Gobby and friends) 👑

🌸 SYNOPSIS 🌸

infinoted-0.7 [options]

that's it. that's the whole invocation. iconic.

🦋 DESCRIPTION 🦋

so infinoted is a dedicated server that lets clients edit plain text documents and source files collaboratively over a network. and the way that changes to the documents get synchronized instantly to all the other clients?? yeah. real-time. no cap. 💅

this server supports the infinote protocol as implemented by libinfinity. example clients include Gobby 0.5.x, Kobby, and a special plugin for gedit. it is NOT compatible with the older libobby protocol — so don't come in here with libobby energy, it's not gonna work. 💀

it also comes with a whole list of plugins like autosave, dbus integration and others. for a complete list see:

https://github.com/gobby/gobby/wiki/Dedicated%20Server

the default plugin is note-text. heads up though: it needs to be added along with any other plugins that you might want to enable. don't forget it, bestie. 🙈

✨ OPTIONS ✨

🎀 Help Options: 🎀

  • -h, --help — show help options. the classic. the beloved. the "wait what was that flag again" saviour. 🫶

👑 Application Options: 👑

  • -c, --config-file=CONFIG-FILE — load the given configuration file instead of looking at the standard locations. you're telling it where to look instead of letting it go feral in the default spots. 💅
  • -k, --key-file=KEY-FILE — the server's private key 🔐
  • -c, --certificate-file=CERTIFICATE-FILE — the server's certificate 📜
yes, -c shows up twice in this page, once for --config-file and once for --certificate-file. that's what the original says, so that's what you get. i don't make the rules. 😭
  • --certificate-chain — the certificate chain to the root certificate, if it's not already included in the file given in --certificate-file.
  • --create-key — creates a new random private key ✨
  • --create-certificate — creates a new self-signed certificate using the given key
  • -p, --port-number=PORT — the port number to listen on 🚪
  • --listen-address=ADDRESS — the IP address to listen on
  • --security-policy=no-tls|allow-tls|require-tls — how to decide whether to use TLS. pick your fighter: no-tls, allow-tls, or require-tls. 🛡️
  • -r, --root-directory=DIRECTORY — a directory to save the document tree into in infinoted-xml format. this is the location where the tree is kept persistently, so that it's available again after a server restart. usually, documents are saved in this tree 60 seconds after the last user left the session. plus, when the autosave plugin is enabled, it's possible to save sessions into the tree periodically. the default directory is ~/.infinote. 🏠
  • --plugins=PLUGIN — additional plugin to load. repeat the option on the command-line to specify multiple plugins, and use semi-colons in the configuration file. plugin options can be configured in the configuration file (one section for each plugin), or with the --plugin-parameter option. 🧩
  • --plugin-parameter=PLUGIN:KEY:VALUE — sets the option KEY for plugin PLUGIN to the given VALUE. normally, plugin options are specified in the configuration file, but this command line option allows one to set or override plugin options on the command line. very slay of it honestly. 💅
  • -P, --password=PASSWORD — require given password on connections 🔑
  • --pam-service=SERVICE — authenticate clients against given pam service on connection
  • --pam-allow-user=USERS — users allowed to connect after pam authentication. separate entries with semicolons. ⚠️
  • --pam-allow-group=GROUPS — group allowed to connect after pam authentication. separate entries with semicolons. ⚠️
  • -d, --daemonize — daemonize the server 👻
  • -D, --kill-daemon — kill a running daemon 💀
  • -v, --version — display version information and exit. and then it just... leaves. main character exit. ✨

🌈 AUTHOR 🌈

infinoted and libinfinity were written by Armin Burgmeier <armin@arbur.net> — thank you for your service, king 🫶

and that's the page bestie!! this was infinoted 0.7, from August 2014, section 1 of the manual, INFINOTED(1) — go forth and collaborate, fr fr 💖🌸🎀

📦 where this page comes from