GeneralShare 1.1.0 for Windows 10 / Windows 11 (64-bit)
=========================================================

GeneralShare sends files and clipboard text directly between devices on the
same local network. No account, cloud, ads or analytics.

This ZIP is self-contained: it does not need Rust, Visual Studio or the
Visual C++ Redistributable.

Install
-------

1. Extract the whole ZIP to a normal folder (do not run from inside the ZIP).
2. Double-click install.cmd.
3. Start "GeneralShare" from the Start Menu.
4. The receiver window shows a 6-digit pairing code and QR code.

The installer is per-user and does not need administrator rights. It installs
to %LOCALAPPDATA%\GeneralShare and adds:

  - Start Menu shortcut
  - Explorer right-click entry (Windows 11: "Show more options")
  - Send To -> GeneralShare
  - optional login autostart (run install.cmd with -StartWithWindows)

LocalSend bridge (optional)
---------------------------

generalshare-localsend.exe lets HarmonyOS / Android / iOS phones that run a
LocalSend-compatible app exchange files with this computer. It is a separate
process and is off by default:

  set LS_MODE=probe  && generalshare-localsend.exe   (only watch nearby devices)
  set LS_MODE=receive && generalshare-localsend.exe  (accept incoming transfers)
  set LS_AUTO_ACCEPT=1 to skip manual approval (testing only, trusted LAN only)

The bridge listens on port 5135 and writes to .\_localsend by default.

Browser transfer
----------------

Open http://<this-pc-ip>:5134/ in any browser, pair with the 6-digit code and
send or download files without installing the app on that device.

Unsigned binaries
-----------------

These executables are not code-signed, so SmartScreen may warn on first run.
Verify the SHA-256 published next to the ZIP before running.

If Windows Firewall asks, allow access on private networks. If it does not ask
or discovery fails, run this once in an Administrator PowerShell:

  netsh advfirewall firewall add rule name="GeneralShare" dir=in action=allow program="%LOCALAPPDATA%\GeneralShare\generalshare-hub.exe" enable=yes profile=private

Then allow TCP 5134 from your private LAN only.

First use
---------

1. Run GeneralShare on this PC and on the other device.
2. Keep both on the same Wi-Fi/LAN.
3. Scan the QR, or enter the PC's IP address and 6-digit code on the other
   device.
4. The receiver must accept before any file is written.
5. Received files go to %USERPROFILE%\Downloads\GeneralShare.

Command line
------------

  generalshare-send.exe --pair --hub http://192.168.1.20:5134 --code 246810
  generalshare-send.exe "C:\path\to\file" "C:\path\to\folder"

Config is stored in %APPDATA%\GeneralShare\config.json.

Uninstall
---------

Double-click uninstall.cmd. It removes the app, shortcuts and Explorer entries.
Downloads and configuration are kept:

  %USERPROFILE%\Downloads\GeneralShare
  %APPDATA%\GeneralShare

Security
--------

Pairing is required and the receiver must accept before bytes are written, but
this version does not enable TLS. Use it only on trusted local networks, not
public Wi-Fi or guest networks.

The binaries are not code-signed yet, so Windows SmartScreen may warn on the
first run. Verify SHA256SUMS before installing.

Project page: http://www.generaldriver.com/software/support/generalshare/
