Kilim for Windows — licensed beta 0.3.0
Unofficial Windows adaptation of Kilim by Yusuf Yilmaz.

REQUIREMENTS
64-bit Intel/AMD Windows 10 or Windows 11.
This package includes .NET. No additional runtime installation is needed.
A licence key from Polar purchases is required to run this build.
One activation per key, bound to one PC and Windows user.
Internet is required at activation, each launch and checks every 30 minutes.
If a check cannot confirm the licence, the app closes; reconnect and reopen to retry.

RUN
1. Extract the entire ZIP to a folder on your PC.
2. Keep the assets folder beside Kilim.Windows.exe.
3. Double-click Kilim.Windows.exe.
4. Paste your Polar licence key to activate this PC.
5. Find Kilim in the system tray near the clock, including the hidden-icons arrow.

Your licence key and device management: https://polar.sh/suko-pro/portal
Sign in with the email address used for your purchase.

If the build says it is awaiting configuration, it is not ready for customer use.
Packages containing PREVIEW-NOT-FOR-SALE.txt are review/test builds only.

CONTROLS
Drag the rug: move/fold it.
Double-click the rug: roll/unroll it.
Hold Control: reveal desktop icons and click through the rug.
Release Control before dropping a file to move it; holding Control makes Explorer copy.
Ctrl+Alt+K: hide/show the rug, when this shortcut is available.
Right-click the tray icon: patterns, size, custom picture, lighting, sounds and Quit.

SETTINGS AND REMOVAL
Settings and custom pictures are stored in %LOCALAPPDATA%\Kilim.Windows.
Windows protects the saved key and activation ID in activation.dat in that folder.
Use Deactivate this PC in the tray, or Polar's portal, before moving your key.
Launch at sign-in is off until you enable it from the tray menu.
To remove the app, turn off launch at sign-in if enabled, quit Kilim and delete its folder.
Your desktop files remain in place.

BETA DETAILS
This build is unsigned and Windows may display an unknown-publisher warning.
The bundled executable and native rendering library extract runtime files under the
standard .NET temporary folder when launched. The app needs access to your temp folder.
The UI is English. It includes 15 upstream rug images and custom woven pictures.
The prototype has been tested on one Windows PC with two monitors; other shell/display
configurations need further testing. See README.md for implementation details.

Original project: https://github.com/yusufyilmazfr/kilim
Original cloth simulation and artwork: Copyright 2026 Yusuf Yilmaz, MIT license.
See LICENSING.md for activation, device transfers and limitations.
See LICENSE, assets\UPSTREAM-LICENSE.txt, and licenses\ for the bundled runtime notices.
