Skip to content

v0.1.0

Choose a tag to compare

@DevTarlow DevTarlow released this 26 Sep 22:03

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