MCCP — Moddable Console Capture Platform
========================================

A low-latency viewer for a USB capture card (video + audio passthrough), with a
Steam-style overlay and a Lua modding system.

Requirements
------------
  - Windows 10/11, 64-bit. No installation and no runtime downloads needed --
    just run the .exe.
  - A USB video capture device (one that appears to Windows as a "camera").

Running
-------
  Double-click MCCP.exe. Keep the "addons" folder next to the .exe -- that is
  where mods live, and where the ones you download land. On
  first use the app creates "screenshots" and "data" folders beside it. Only one
  copy runs at a time -- a second one tells you so and closes, since the capture
  device is exclusive anyway.

Choosing your capture device
----------------------------
  At startup the app lists every camera/capture device and picks one
  automatically. If it grabs the wrong one (e.g. your webcam), start it with the
  device number or part of its name as an argument:

      MCCP.exe 1
      MCCP.exe Elgato

Controls
--------
  Shift + Tab    Open / close the overlay
  Esc            Close the overlay (or quit when the overlay is closed)

  That is the whole list, because everything else is a mod. Screenshots, for
  instance, are the "Screenshot keys" mod: install it from Workshop ->
  Download mods (no account needed) and P saves the picture while O saves it
  with the overlays drawn in.

In the overlay
--------------
  Options        Window mode (Windowed / Fullscreen / Borderless with a display
                 picker; changes auto-revert after 15s unless you keep them),
                 plus a Developer console toggle.
  Workshop       Everything dasmaffin.com, as its own screen:
                   Account         Sign in. The app and the site are one thing:
                                   signing in is what lets you publish mods, and
                                   the session is remembered between runs
                                   (encrypted to your Windows account -- the file
                                   is useless anywhere else).
                   Upload a mod    Package an addon folder and publish it. New
                                   mods only; updating one is on its Edit screen.
                   My mods         What is installed here: update, uninstall, or
                                   edit its page. Works signed out.
                   Download mods   Everything published on the site that you do
                                   not have yet. No account needed.
  Cartridges     Mods that register games appear as cartridges along the bottom.
                 Only the selected game's mods run; click the selected one again
                 to pop it out and run none of them. Hovering a cartridge shows
                 its mods and their settings.

Modding
-------
  Addons live in the "addons" folder, one per subfolder:
  addons/<name>/lua/autorun/*.lua. See docs/api.html for the full Lua reference,
  including the worker API for running mod code on other cores.

  Mods downloaded from the site arrive as a single .ccmod file and are read
  from it in place -- a folder is yours, a package came from the site. To get
  the raw files out of one, drag it onto ccmod-extract.exe and they appear in a
  folder of the same name beside it.
