KeepOrg for Windows
===================

keeporg-tray.exe is the tray application. keeporg.exe is the same program for a
command prompt: administration commands, and the agent without a tray.

First run
---------
1. Copy both files to %LOCALAPPDATA%\Programs\KeepOrg and start keeporg-tray.exe.
   A padlock appears in the notification area.
2. Choose Open Config from its menu, set "server_url" to your server, for
   example "https://keeporg.example.com", and save.
3. Choose Sign In... and approve the code in the browser that opens, with
   your password or single sign-on.

Your databases appear in %UserProfile%\KeepOrg. Open them with KeePass,
KeePassXC or any compatible application: every save is pushed to the
server, and changes made by other people are applied to the files. The
Databases submenu shows each one's state and opens it.

Tick Start at Login to start KeepOrg when you sign in to Windows.

Settings
--------
%AppData%\keeporg\config.json holds every setting, and the tray applies an
edit as soon as it is saved:

  server_url               the server, as a browser sees it
  device_label             this computer's name in the server's session list
  mirror_dir               where the .kdbx files are kept
  poll_seconds             how often local saves are looked for
  request_timeout_seconds  the limit on one request to the server
  ca_file                  a PEM bundle, for a server behind a private CA
  log_file                 the log; empty means keeporg.log beside config.json
  notifications            desktop notifications (not shown on Windows yet)
  username, token          written by signing in

Without the tray
----------------
  keeporg.exe login -server https://keeporg.example.com -user you
  keeporg.exe run

keeporg-task.xml starts `keeporg.exe run` at logon through Task Scheduler,
for a machine where nobody uses the tray:

  schtasks /create /tn KeepOrg /xml keeporg-task.xml

Only one agent synchronizes a directory at a time; a second one reports
that the first is running and stops.

Conflicts
---------
If someone else saved first, your save is kept beside the file as
<name>.conflict-<timestamp>.kdbx and the server copy is restored. Open both
in KeePass and merge them, or ask a group administrator to switch the
database to another merge strategy.