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%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
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.
|
||
| 00-template | ||
| 01-fat32-usb-image-builder | ||
| 02-dedupe-movies | ||
| 03-dedupe-tv-shows | ||
| 04-purge-forgejo-action-runs | ||
| 05-arw-to-jpg | ||
| 06-png-to-web-icons | ||
| 07-routeros-wireguard-roadwarrior | ||
| 08-freescout-license-migrator | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
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
- Copy
00-template/README.mdtoNN-tool-name/README.mdand fill it in. - Add the tool, its own
.gitignore, and any wrappers it needs. - Add a row to the table above.
- Keep the tool self-contained so it can be used independently.
License
Repository
Remote: ssh://git@git.jdneer.com:29500/jd/jdneer-toolbox.git