Find, download and delete JSON files from cloud drives

Textual TUI for finding, downloading, and optionally deleting JSON files from rclone remotes. Files are moved to remote:deleted-json-files (not permanently deleted) so you can recover them if needed.

Requirements

• Python 3.10+
• rclone installed and configured
• macOS for "Open in Finder" (optional)

Installation

pip install -e .

Or with uv:

uv sync --extra dev

Usage

rclone-cleanup-json-files

Or with uv:

uv run rclone-cleanup-json-files

Or:

python -m rclone_cleanup_json_files.app

(From the project root with src on PYTHONPATH or after pip install -e ..)

Flow

1. Select an rclone remote from the list
2. Select a top-level path on the remote (or root)
3. Enter or browse to a local destination folder
4. JSON files are downloaded to {dest}/{remote}-{path}/
5. Optionally open in Finder (macOS)
6. Optionally move from remote to remote:deleted-json-files/{path} (backup, not permanent delete)

Author

Rich Lewis - GitHub: @RichLewis007