Vapor for Windows
=================

Vapor is a self-hosted personal media server. The Windows beta release is
published as:

  vapor-setup-windows-amd64.exe
      per-user installer

  vapor-server-<version>-windows-amd64.zip
      portable tray + server payload

When the release host cannot build the NSIS installer, only the portable zip is
published.

Install
-------

Run:

    vapor-setup-windows-amd64.exe

The installer copies Vapor to:

    %LOCALAPPDATA%\Vapor

It creates Start Menu shortcuts and registers Vapor in the current user's Run
key so the tray starts at sign-in. It does not require administrator rights.

Portable Zip
------------

Unzip the archive into a folder you keep. The zip contains:

  vapor-tray-windows-amd64.exe   native tray shell
  vapord.exe                     server with the web client embedded
  README.txt                     this file

Keep the tray and server in the same folder, then double-click:

    vapor-tray-windows-amd64.exe

What The Tray Does
------------------

The tray starts vapord.exe on a free loopback port, verifies that it is the
right server, and opens Vapor in your browser. The tray menu has:

  Open Vapor
  Restart
  Start at Login
  Quit

Use Start at Login to opt in or out when running the portable zip. The
installer enables sign-in startup automatically through the current user's Run
key.

Add Your First Library
----------------------

1. Open Vapor from the tray or Start Menu.
2. Choose Add Library.
3. Select a mode such as Music, Movies, or TV.
4. Choose a local folder, or add an SMB network share.
5. Click Create & scan.

Vapor scans read-only. It never renames, moves, edits, or deletes files in your
media folders.

For SMB, enter smb://host/share or \\host\share plus credentials in the Add
Library storage picker. Passwords are stored server-side and are never returned
to clients.

Server-Only Mode
----------------

To run without the tray, start vapord.exe directly:

    vapord.exe -db "%LOCALAPPDATA%\Vapor\library.db"

Then open:

    http://127.0.0.1:8770

Direct server mode listens on loopback by default. To expose it on the LAN:

    vapord.exe -db "%LOCALAPPDATA%\Vapor\library.db" -addr 0.0.0.0:8770

Non-local clients must pair from the local console before they can browse or
play.

Updates
-------

When vapord.exe is run directly, it checks the release manifest daily,
verifies the new payload's sha256, and swaps vapord.exe in place for the next
restart.

Tray-managed beta installs should be updated by running a newer installer or
replacing the portable zip contents. Opt out of direct server self-update with:

    vapord.exe ... -no-selfupdate

Troubleshooting
---------------

Cannot open Vapor:

  Use the tray menu's Open Vapor or Restart. In portable mode, confirm
  vapord.exe is beside vapor-tray-windows-amd64.exe.

Library unreachable:

  Reconnect the disk, mount the NAS, or update SMB credentials, then use Retry
  or rescan the library.

Reset:

  Quit the tray. Move %LOCALAPPDATA%\Vapor aside for a full reset, or delete
  %LOCALAPPDATA%\Vapor\library.db for a database-only reset. Media files are
  not modified.
