Skip to content

Frandycode/moldifiles

Repository files navigation

MOLDIFILES

Non-destructive batch renaming — Shape your Files your Way

MOLDIFILES is a browser-based file renaming tool that lets you design powerful naming patterns and apply them across entire batches of files — or a single file — without ever touching the originals. Load a folder (or a .zip), build your pattern with intuitive naming slots and tokens, preview every resolved name live, then download a clean zip of renamed files.

A CLI is also available for terminal-based workflows and automation.


Features

  • Non-destructive — your original files are never modified; a renamed zip is generated on download
  • Batch or single file — works with individual uploads or entire zip archives (folder structure preserved)
  • Four naming slots — Prefix · Name Body · Suffix · Extension, each independently controllable
  • Token system — dynamic values like {date}, {counter}, {original_clean}, and more
  • Rule Sets — apply different naming conventions per file extension within the same batch
  • Per-file overrides — pin any slot for individual files without breaking the global pattern
  • Conflict detection & resolution — automatic counter, timestamp, or manual block strategies
  • Saved templates — store and reuse naming patterns across sessions; export/import as JSON
  • Undo / Redo — 50-step history of every pattern change, Ctrl+Z / Ctrl+Y
  • Rename history log — searchable before → after manifest for every processed batch
  • Theme system — Dark/Light mode × 5 accents (Steel, Cobalt, Ember, Jade, Silver)
  • Onboarding tour — guided 5-step walkthrough for new users
  • Full documentation — in-app help page with 14 sections and a customizable cheat sheet
  • Keyboard shortcuts — power-user friendly
  • CLI — run rename jobs from the terminal, pipe into scripts, use in CI

Quick Start

Web app

  1. Open the app in any modern browser (no install required)
  2. Drop files or a .zip onto the drop zone
  3. Build your pattern in the Naming Convention panel using slots and tokens
  4. Check the Preview panel — names resolve in real time
  5. Fix any conflicts if flagged, then click Rename & Download
  6. A renamed .zip is saved to your Downloads folder — manifest included

CLI

cd cli && npm install && npm run build && npm link

# Preview first
moldifiles rename -i batch.zip --prefix "Req_" --suffix "_{date}" --dry-run

# Run it
moldifiles rename -i batch.zip --prefix "Req_" --suffix "_{date}"

# Full guide
moldifiles help

Token Reference

Token Description Example output
{original} Full original filename (no extension) EDU-S4H-S2P
{original_clean} Original with hyphens/spaces → _ EDU_S4H_S2P
{date} Today in mmddyy 041026
{date:mmddyyyy} Today in mmddyyyy 04102026
{date:yyyy-mm-dd} Today in ISO format 2026-04-10
{counter} Auto-incrementing 001, 002 001
{counter:start=5} Counter from custom start 005
{ext} Original file extension (no dot) pdf
{custom} User-defined value Final
{custom:2} Second custom slot Draft

Project Structure

moldifiles/
├── src/                  ← Web app source
│   ├── components/       ← UI components
│   ├── lib/              ← Core rename engine, token resolver, validator
│   ├── hooks/            ← Theme system
│   └── store/            ← Zustand state management
├── cli/                  ← CLI tool (Node.js + Commander)
│   ├── bin/              ← Entry point
│   └── src/              ← Shared core logic + CLI-specific handlers
├── public/               ← Static assets, favicon
└── index.html

Tech Stack

See TECH.md for the full technical specification.


Usage Guide

See USAGE.md for detailed instructions, token reference, and pattern examples.


CLI Reference

See cli/README.md for the full CLI reference including all commands, flags, and examples.


Changelog

See CHANGELOG.md for the full release history.


Roadmap

Phase Status Description
Phase 1 ✅ Complete Web app — full rename pipeline, UI, themes, docs
Phase 2 ✅ Complete CLI — rename, manifest, validate, list-tokens, help
Phase 3 🔲 Planned Desktop app (Tauri)

Author

See AUTHORS.md.


License

© 2026 Frandy Slueue. All rights reserved.

About

Batch file renaming done right — drop a zip, build a naming pattern using tokens like {date} and {counter}, preview every rename live, and download clean copies. Web app + CLI. Originals never touched.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors