v0.2.0

Background Swapper 0.2.0 gives the interface its own opacity controls, and lets
you keep the balance you land on.

What's new

Three sliders instead of one. The old Element opacity faded every surface
at once, so seeing the photo well and keeping the interface readable pulled
against each other. Now:

• Background opacity fades the ground the app frame paints — lower it and the
  photo fills the open page.
• Element opacity fades the cards, inputs and menus raised over that ground,
  so the text on them stays readable.
• Sidebar opacity fades the left column on its own, so the navigation can stay
  solid while the panels go glassy.

They ship at 20% for the ground and 85% for the panels and the sidebar, and each
has its own Reset.

Looks you can save. Appearance opens with Wallpaper, Glass and
Solid, and Save current keeps whatever the sliders are on under a name of
your own. A saved look sits in the row beside the shipped ones, loads in one
click, and carries a small cross to remove it. A look holds the three opacities
and nothing else, so loading one never undoes your Tint or Blur.

Upgrading

Your photos, your settings and your saved looks are untouched. An index written
by 0.1.0 reads back exactly as it looked: its single opacity becomes the element
alpha, and the sidebar inherits the value that governed it.

Fixes

• The primary Save button no longer takes its label from a token the opacity
  sliders fade, so it stays readable at the low background opacities the sliders
  exist to reach.
• PATCH /state now refuses a field it does not know instead of ignoring it. The
  two halves of the plugin load separately, so a browser half a version ahead used
  to have its write answered 200 and dropped — which is how a saved look could
  be lost.

Install

Paste this repository's address into Plugins → Install, or pin this release:

https://github.com/DevTarlow/dsh-background-swapper#v0.2.0

v0.1.0

The first release of Background Swapper, a DeepSeek Harness plugin that puts your
own photo behind the interface and gives you the controls to keep it readable.

What you get

Swap Background sits just above Settings in the left sidebar. Open it to add a
photo, give it a name, and keep a library of favorites.

• Add a photo by dropping it on the panel or picking a file. Anything longer
  than 2560 pixels on a side is scaled down first, and the panel says when that
  happened.
• Keep a library in Recent, newest first, six to a page. Click a thumbnail
  to switch to it.
• Rename or delete any entry, or empty the library with Remove all photos.
• Tint from Darken 100% to Lighten 100%, for when text is hard to read over
  a bright photo.
• Element opacity makes the interface see-through so the photo shows behind it.
  It starts at 50%.
• Blur from 0 to 24 pixels.
• Turn off hides the photo and puts the interface back, without deleting
  anything.

Your photos live with the Harness in ~/.dsh/storages/background-swapper/, not
inside the plugin, so the same library and the same look appear in every browser
and in the desktop app pointed at that Harness.

Install

In the Harness, open Plugins, press Install, and paste this repository's
address:

https://github.com/DevTarlow/dsh-background-swapper

Then refresh the page. The plugin stays available in every session until you remove
it.

Requirements

The DeepSeek Harness, in a browser or the desktop app, and Node.js 22 or newer.

There is no build step. The host half imports only node: builtins and the browser
half only React, which the Web shell already provides — that is what lets the plugin
load on a released dsh.

Notes

A new install starts with Tint None, Element opacity 50% and Blur off;
the Reset link beside each slider returns it to those values. Four settings —
pageSize, maxImageBytes, maxDimension and dataDir — are read from
cordis.patch.yml, and the README has the table.

Both test harnesses pass on this commit: the host surface over real HTTP, and the
browser registrations and painter CSS against a stub loader.

Full changelog: https://github.com/DevTarlow/dsh-background-swapper/commits/v0.1.0