A personal toolbox of standalone, numbered utilities for systems, networking, DevOps, security, automation, media, firmware, and everyday problem-solving. Each tool lives in its own directory with its own README, scripts, and dependencies, so you can copy or use any single one without the rest of the repo.
  • Python 49.5%
  • PHP 33.2%
  • Shell 17.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
JD Bungart 3ce932cb62 freescout-license-migrator: bulk license rebinding after a domain move
FreeScout licenses paid modules per domain and offers no bulk way to move
them: after a domain change each module's key has to be released and
re-activated one at a time under Manage -> Modules. This does the whole set
in one pass, from a file of "Module Name: key" lines pasted out of the
remind-license-keys email, read from license-keys.txt, --file or --paste.
Confirmed on a production instance: 58 modules, zero failures.

It runs on the server inside the install, in PHP 8.0+ since the host already
has it, and bootstraps the app to call FreeScout's own WpApi and Module
classes. No artisan command activates or deactivates a license; both exist
only behind ModulesController::ajax(). The key is released with url '*',
as the UI's "Deactivate License" transfer does, because after a move it is
bound to the old host and releasing the current one would do nothing.

One bulk check_licenses call classifies every module before anything is
changed: valid is left alone (or repaired locally if the row is stale),
site_inactive is released and re-activated, inactive is only activated,
expired/disabled/invalid and unrecognised answers are skipped. Re-runs are
idempotent, and an unexpected reply from the closed licensing server means
inaction rather than a guess. Each module keeps its on/off state;
--enable-disabled switches listed modules on, for the case where the daily
license check disabled them after the move.

Before the first write: the host is read through config('app.url'), refused
if empty, localhost or an IP, asserted with --expect-domain or confirmed
after the plan is shown; the daily freescout:module-check-licenses time is
derived from crc32(APP_KEY) as Kernel.php does, and --apply refuses to
start if the run would overlap it, judged again on measured latency just
before the first write; installed licensed modules missing from the file and
names matching nothing block the run; third-party modules are skipped; a
lock in the state directory and an flock on the install's artisan file stop
a second run, whatever its --state-dir.

Dry run by default, with two read-only API calls. Under --apply: 1 s
between calls (the server itself takes about 8 s per call and never
throttled), three attempts with backoff on transient failures only, never on
a permanent license error. Every step is journalled and fsynced; --resume
continues an interrupted run, cuts back a line torn by a hard kill, and
refuses if the keys, host or install path changed. Each local write is read
back after clearing Module's per-process cache. Caches are cleared once at
the end. Keys are masked in all output unless --log-keys; every state file is
created mode 0600. Each row shows its time and the run ends with a runtime
total.

The README covers the key file, the checks, the flags, what the real
migration measured, and the Cloudron web terminal step by step (read-only
/app/code, keys in /tmp so they stay out of backups, sudo -E -u www-data,
setsid -f for long runs), verified on app package 1.17.0.

Verified against FreeScout 1.8.248 (dist 56c4d014) by reading the source,
then exercised against a stub install reproducing WpApi's error semantics,
the Module static cache and a stateful license server, in 42 scenarios on
PHP 8.0, 8.3 and 8.4; SIGINT and SIGTERM checked with pcntl; eight
deliberately broken copies each caught by the suite.
2026-10-24 02:50:47 +08:00
00-template jdneer-toolbox 2026-08-30 01:55:40 +08:00
01-fat32-usb-image-builder jdneer-toolbox 2026-08-30 01:55:40 +08:00
02-dedupe-movies jdneer-toolbox 2026-08-30 01:55:40 +08:00
03-dedupe-tv-shows jdneer-toolbox 2026-08-30 01:55:40 +08:00
04-purge-forgejo-action-runs purge-forgejo-action-runs: correct the token scope, stop on refusal 2026-08-30 02:02:24 +08:00
05-arw-to-jpg arw-to-jpg: add Sony ARW to JPEG converter 2026-09-07 22:57:55 +08:00
06-png-to-web-icons png-to-web-icons: add PNG logo to web icon set generator 2026-09-16 05:55:47 +08:00
07-routeros-wireguard-roadwarrior Update 07-routeros-wireguard-roadwarrior/README.md 2026-10-15 14:13:15 +00:00
08-freescout-license-migrator freescout-license-migrator: bulk license rebinding after a domain move 2026-10-24 02:50:47 +08:00
.gitignore jdneer-toolbox 2026-08-30 01:55:40 +08:00
LICENSE jdneer-toolbox 2026-08-30 01:55:40 +08:00
README.md freescout-license-migrator: bulk license rebinding after a domain move 2026-10-24 02:50:47 +08:00

jdneer-toolbox

A personal toolbox of standalone, numbered utilities for systems, networking, DevOps, security, automation, media, firmware, and everyday problem-solving. Each tool lives in its own directory with its own README, scripts, and dependencies, so you can copy or use any single one without the rest of the repo.

Tools

# Tool Description
00 template README template and structure for new tools
01 fat32-usb-image-builder Build a mountable FAT32 USB mass-storage image from files in src/
02 dedupe-movies Deduplicate a Jellyfin movie library by IMDb ID, keeping the best-quality copy
03 dedupe-tv-shows Deduplicate a Jellyfin TV library by IMDb ID, keeping the most complete copy without losing episodes
04 purge-forgejo-action-runs Bulk-delete Forgejo Actions workflow runs for the repository a checkout points at, keeping the newest N
05 arw-to-jpg Batch-convert Sony ARW raws to sRGB JPEGs with LibRaw, carrying camera, lens and exposure metadata over
06 png-to-web-icons Turn one PNG logo into a full favicon, PWA, Apple, Windows and social icon set, stripping C2PA, EXIF and text metadata
07 routeros-wireguard-roadwarrior Add, list, re-key and remove full-tunnel WireGuard road-warrior peers on a RouterOS 7 router, with automatic address assignment, a .conf and a terminal QR code
08 freescout-license-migrator Re-bind every FreeScout paid-module license key to a new domain in one pass, with a dry-run plan and a resumable run

Layout

Each tool lives in its own numbered directory:

NN-short-name/
├── README.md          # Tool-specific documentation
├── .gitignore         # Tool-specific exclusions
└── ...                # The tool itself

The root README.md indexes the tools. The root .gitignore handles global exclusions (AI artifacts, OS files, IDE files, model downloads). Each tool's own .gitignore handles its build artifacts and input/output directories.

Adding a new tool

  1. Copy 00-template/README.md to NN-tool-name/README.md and fill it in.
  2. Add the tool, its own .gitignore, and any wrappers it needs.
  3. Add a row to the table above.
  4. Keep the tool self-contained so it can be used independently.

License

MIT

Repository

Remote: ssh://git@git.jdneer.com:29500/jd/jdneer-toolbox.git