NATURE SWAP — calm media blocker for Chrome, Edge, Brave and Arc
=================================================================

INSTALL (about a minute)
1. Unzip this folder somewhere permanent (e.g. Documents/Extensions/nature-swap).
   Don't delete the folder afterwards — the browser loads the extension from it.
2. Open  chrome://extensions  (Edge: edge://extensions, Brave: brave://extensions).
3. Turn on "Developer mode" (top-right in Chrome; left sidebar in Edge).
4. Click "Load unpacked" and choose the unzipped nature-swap folder
   (the one that contains manifest.json).
5. Pin it: click the puzzle-piece icon in the toolbar, then the pin next to Nature Swap.
Reload any tabs that were already open.

USING IT
- Pick what to swap in the toolbar popup:
    Everything  - images, videos and ads are swapped
    Ads only    - only ads change; they still load (sites still get paid) but you see a scene
  Images, videos and ads each have their own setting: Replace, Hide (blank space), or Show.
- Theme packs: Nature (the base pack), Ocean & Coast, Desert, Winter and Cosmos. Switch on
  as many as you like. Each pack gets an equal share of the page.
- Your own packs: Settings > Theme packs > New pack. Drop in photos and MP4/WebM clips.
  They stay in your browser only: never uploaded, never shared, never shown to anyone else.
- Videos get a live animated scene (or one of your clips, or a slow zoom of your photo).
- Right-click anything and choose "Show the original here" to reveal one item.
- Shortcuts: Alt+Shift+N pauses/resumes the current tab; Alt+Shift+W whitelists the current site.
- Settings page: whitelist (sites, single pages, or * patterns), a URL tester, the size of
  images to leave alone, what happens to video sound, a schedule, and export/import.

WHITELIST EXAMPLES
  youtube.com                      -> the whole site, including all subdomains
  https://news.site.com/a/story    -> only that page
  youtube.com/watch*               -> every URL that matches the pattern
  *.gov/*                          -> every .gov site

UPDATING
Replace the folder contents with the new version, then click the reload arrow on the
Nature Swap card in chrome://extensions.

Your photos, settings and whitelist stay in your browser. The extension only downloads the
list of Nature Swap ads; it never uploads your photos or what you browse.
