=====================================================================
                    SCREEN VEIL - DOUBLE-CLICK AND GO
                  (Linux - one page, keep with the tool)
=====================================================================

Screen Veil covers your screen with a privacy veil while your
computer session stays alive underneath - so Muse keeps working
with your browser while nobody at the computer can see or touch
anything. It is a privacy veil, not the system lock.

Screen Veil is FREE on every platform.

BEFORE YOU START - THE ONE THING THAT MATTERS
  Unzip the WHOLE zip file first (step 2 below). Screen Veil will
  not work from inside the zip preview window.

WHAT YOUR COMPUTER NEEDS (one-time)
  Python 3 with tkinter. Most Linux systems have Python already;
  if the launcher says Python was not found, install both with
  one command (Ubuntu/Debian):

      sudo apt install python3 python3-tk

  then run the launcher again.

---------------------------------------------------------------------
  HOW TO LOCK YOUR SCREEN
---------------------------------------------------------------------

  1. Find the zip file you were given (for example in Downloads).

  2. Extract it: right-click the zip and choose "Extract Here"
     (or run: unzip screen-veil-linux-2026-11-13.zip). A new
     folder called "ScreenVeil" appears. Open it. Never run
     anything from inside the zip preview.

  3. Inside the "ScreenVeil" folder, start Screen Veil with ONE
     action - either one works:

       a) Double-click  >>>  Screen-Veil.desktop  <<<
          (On GNOME you may first need to right-click it and
          choose "Allow Launching".)

       b) Or double-click  >>>  Screen-Veil.sh  <<<
          and choose "Run in Terminal" if your file manager asks.

     From a terminal, the same thing is:  ./Screen-Veil.sh

  4. A terminal opens. The FIRST time only, it asks you to
     SET THE ADMIN PASSWORD for the login "Meeyahkah":

       - Type a password of at least 8 characters, press Enter.
       - Type the SAME password again, press Enter.
       - The letters do NOT show while you type. That is normal.
       - There is NO default password. If you skip this, the
         veil will not lock - run the launcher again.
       - REMEMBER this password. It is how you unlock.

  5. The veil covers the whole screen. It shows "Screen Veil"
     and "Admin login - Meeyahkah". Your session keeps running
     underneath. LEAVE THE TERMINAL OPEN - if you close it,
     the veil stops.

  Done - you can walk away.

---------------------------------------------------------------------
  HOW TO UNLOCK
---------------------------------------------------------------------

  - On the computer: click the password box, type YOUR admin
    password, press Enter. The veil lifts at once.
  - Or ask Muse: "unlock my screen." Muse can lift the veil
    remotely (you must give Muse the IPC secret once - the
    manual, section 3B, explains how, step by step).
  - Wrong password 5 times? The screen makes you wait (30
    seconds, then longer). The right password still works
    after the wait, and Muse's remote unlock works too.

---------------------------------------------------------------------
  CHANGE YOUR PASSWORD
---------------------------------------------------------------------

  Run "Change-Password.sh" in the same folder (double-click it
  and choose "Run in Terminal", or ./Change-Password.sh). Type
  the CURRENT password, then the new one twice.

---------------------------------------------------------------------
  HONEST LIMITS (short version - full list is in the manual)
---------------------------------------------------------------------

  - X11 sessions: full input blocking. Wayland sessions: the
    veil is a FULLSCREEN COVER ONLY, with a notice on screen -
    input blocking is not guaranteed on Wayland. For full
    blocking, log in to an X11 session. Check which you run
    with:  echo $XDG_SESSION_TYPE
  - If the veil ever fails badly, it locks the system properly
    (the normal sign-in screen) instead of leaving you exposed.
  - Screen Veil keeps your session alive while Muse works.
    If you leave the computer unattended for a long time, the
    normal system lock is still the safer choice.

  Problems? The manual (manual/user-guide.md inside this
  folder) has an "If it fails" section for every problem we
  know about.

=====================================================================
