JM Tech Power

jm-tech-power-official/Cargo

Cargo — a desktop batch file mover. Preview every move before it happens, move or copy without ever overwriting, and undo the last batch. Built with Qt (PySide6). (JM Tech Power's mover — not Rust's cargo.)

Public Tools Windows, macOS, Linux LGPL-3.0 (PySide6)
README.md

Cargo — batch file mover (desktop app)

A polished desktop GUI for moving/copying files in bulk, with a dry-run preview and journaled undo.

Category: Tools · OS: Windows · Linux · macOS · Version 1.0.0

⚠️ Not Rust's cargo. This is JM Tech Power's Cargo, a desktop
file-mover. It has nothing to do with the Rust package manager / build tool
that is also called cargo. If you use Rust, don't put this launcher on your
PATH ahead of Rust's cargo.

Built with PySide6 (the official Qt for Python bindings — not PyQt). Green accent, clean dark UI. The file-operation / journal / undo logic is plain standard-library Python, so it stays testable without any GUI toolkit.

Install

Requires Python 3 (the installers check for it and tell you how to get it). Each installer creates an isolated per-app virtual environment and installs PySide6 into it — nothing is added to your system Python.

Linux / macOS — user-local, no sudo:

./install.sh cargo # launches the GUI

Code installs to ~/.local/share/cargo-app/ (a venv + cargo.py), a launcher is placed at ~/.local/bin/cargo, and on Linux a cargo.desktop entry is added so it shows up in your app menu.

Windows — in PowerShell (from the unzipped folder):

.\install.ps1 cargo

Installs to %LOCALAPPDATA%\Programs\cargo\ (venv + cargo.py), adds a cargo.cmd launcher, and puts that folder on your user PATH.

Uninstall with ./uninstall.sh (Linux/macOS) or .\uninstall.ps1 (Windows). Uninstalling removes the app install dir, launcher, and desktop entry, but never deletes your undo journal.

Using it

  1. Source — click Add files… to multi-select files with the picker,

and/or type a glob pattern with an optional base folder (e.g. base ~/Downloads, pattern *.pdf). The two combine. ~ is expanded.

  1. Destination — choose the target folder (created if missing).
  2. Operation — pick Move or Copy.
  3. Preview (dry run) — see every planned source → destination in the

table. Nothing on disk changes.

  1. Move / Copy — perform the batch. Colliding names are auto-suffixed

(report.txt → report (1).txt); Cargo never overwrites.

  1. Undo last batch — reverses the most recent batch. Moves go back to their

originals; copies are removed. The History panel lists past batches.

The status bar reports results after every action.

Undo journal

Every real batch is recorded to an undo journal at ~/.local/share/cargo/journal.jsonl (one JSON object per line; honors XDG_DATA_HOME). This is intentionally a different directory from where the app code installs (~/.local/share/cargo-app/), so reinstalling or removing the app never touches your history. Undo reverses the most recent batch and pops it from the journal.

Command line

cargo # launch the GUI cargo --version # prints "cargo 1.0.0" (does not import PySide6) cargo --selftest # build the GUI headlessly (offscreen) and exit 0 cargo --help

Notes

  • Collision policy: auto-suffix, never overwrite — for both the batch and

for undo (if an original path is reoccupied, the returned file is suffixed).

  • --version and the core logic never import PySide6; the GUI is imported

lazily only when actually launched.