Official User Guide & Documentation • Windows 10 & 11 (64-bit)

KyteRename User Manual

Master everything from dual-pane 50ms sub-latency preview, Amber Gold regex matching, and EXIF/ID3 metadata extraction to 3-stage DAG safe topological renaming and Ctrl+Z atomic undo.

01

Quick Start & 3-Step Rapid Workflow

KyteRename is engineered to deliver the smoothest, most intuitive renaming experience on Windows. Process tens of thousands of files in just three simple steps:

Step 1

Drag in Files or Folders

Select files or entire directories directly from File Explorer and drop them into KyteRename; or right-click in Windows and choose "Batch Rename with KyteRename".

Step 2

Configure Rules with Live Preview

Combine replacements, prefixes, suffixes, numbering, or EXIF tags in the right-hand panel. The left pane highlights matches in Amber Gold while the right pane renders results in under 50ms.

Step 3

Execute Rename Safely

Press Enter or click "Execute Batch Rename". The DAG topological engine safely commits the operation and automatically creates an atomic undo snapshot.

Command-Line Interface (CLI) Support: Launch directly with target directory paths, e.g.: python main.py "D:\Photos\2026" to import all items automatically.
02

Dual-Pane Live Preview & Amber Gold Highlights

Legacy batch renamers leave users in anxiety—wondering what files will look like after renaming. KyteRename eliminates guesswork with high-contrast dual-pane live comparisons:

Amber Gold Match Delegate (Regex Highlighting)

As you type text or regex into search fields, KyteRename immediately highlights the exact matched characters in the original filename column with an Amber Gold background:

Original Filename: DSC_20261005_001.JPG

You can immediately confirm which parts will be replaced and which will remain, granting total clarity before committing any changes.

Qt Virtual Scrolling Technology

Built upon QAbstractTableModel. Even with 10,000+ files loaded, the application only renders visible rows. Synchronized dual vertical scrolling ensures buttery 60 FPS performance with full recalculations in under 50ms.

03

Target Scope & Precision Modification Control

To prevent accidental changes to file extensions that could break format associations, KyteRename offers strict "Target Scope" options for every rule:

Base Name Only
Default Safe Mode

Affects only the filename preceding the extension dot. Extensions are strictly protected from accidental regex or replace operations.

Extension Only
Extension Dedicated

Affects only the extension following the dot. Ideal for converting uppercase camera .JPG to lowercase .jpg, or correcting mismatched extensions.

Full Filename
Advanced Custom

Processes the base name and extension together as a single unified string. Perfect for advanced regex re-structuring across the entire filename.

04

Find & Replace with Regular Expressions (RegEx)

KyteRename embeds Python's high-speed native regular expression engine, supporting capturing groups and back-reference restructuring:

Back-Reference Syntax Support

Supports modern standard $1, $2, $3 syntax as well as classic \1, \2, \3 back-references seamlessly.

Objective RegEx Pattern Replacement Example Output
8-Digit Date to Hyphenated (\d{4})(\d{2})(\d{2}) $1-$2-$3 2026-10-05
Swap Prefix & Suffix Order ^(.*)_(.*)$ $2 - $1 Title - Artist
Strip All Bracketed Content \[.*?\] (leave empty) Clean_Title.mp4
05

Smart Serial Numbering Rules

Sequential numbering is fundamental for organizing documents, photo albums, and contracts. KyteRename's numbering engine provides maximum flexibility:

Flexible Parameters
  • • Start Index: Start from 1, 0, or any arbitrary integer (e.g. 101).
  • • Step Increment: Specify increments (+1, +2, or custom steps).
  • • Zero-Padding: Set to 3 digits to produce 001, 002; 4 digits for 0001.
Placement Configuration
  • • Prefix: e.g. 001_Photo.jpg
  • • Suffix: e.g. Photo_001.jpg
  • • Replace Entire Name: Replace the base name entirely with serial numbers.
06

Photo EXIF & Audio ID3 Tags Guide

Insert curly brackets {variable_name} into your templates. Asynchronous background threads will automatically parse and substitute real metadata dynamically:

Photo EXIF Variables

{exif_date}
Camera Original Shutter Date
(e.g. 2026-10-05_143000)
{resolution}
Width x Height Resolution
(e.g. 3840x2160)
{camera}
Camera Brand & Model
(e.g. Sony_A7M4)

Music ID3 & Audio Tags (MP3 / FLAC / M4A)

{artist}
Artist / Performer
{album}
Album Title
{track}
Track Number (zero-padded)
{title}
Official Song Title

System & Shared Variables

{original}
Original Unmodified Base Name
{parent}
Parent Directory Name
{date}
Filesystem Modified Date
{n}
Current Sequential Index
07

Chinese Pinyin Conversion & Character Sanitization

To resolve encoding errors across English servers, cross-platform transfers, and code compilation pipelines, KyteRename provides targeted sanitization tools:

Chinese to Pinyin Modes (pypinyin Engine)

Full Pinyin Lowercase: qing_tian
CamelCase Capitalized: Qing_Tian
Initials Abbreviation: qt

Illegal Characters & Symbol Sanitization

Automatically replace Windows-prohibited characters (\ / : * ? " < > |) with custom underscores or safe spaces, and batch-strip noisy decorative brackets (such as 【】★◆).

08

3-Stage DAG Safe Topological Renaming Technology

This is KyteRename's industry-leading core innovation. When batch renames encounter complex dependency chains or deadlocks, traditional renamers often cause catastrophic file overwriting and permanent data loss:

// Classic cyclic dependency: Swapping A to B, and B to A
If executed in sequential order by traditional tools:
Step 1: A.txt ➔ B.txt (Original B.txt is overwritten and deleted! Total disaster!)
// KyteRename DAG topological cycle-breaking execution:
Stage 1: Analyze directed graph topological cycles and detect dependency conflict.
Stage 2: Temporarily rename A.txt with microsecond token __kyte_tmp_12345.tmp
Stage 3: Safely execute B.txt ➔ A.txt
Stage 4: Atomically commit the temporary token to B.txt (Perfect zero-loss swap!)
NTFS Case-Insensitive Two-Phase Transition

Windows does not distinguish casing. Changing file.txt to FILE.TXT automatically employs two-phase commits to prevent "File already exists" system errors.

Windows MAX_PATH Extended Path Protection

Automatically attaches Windows \\?\ extended path prefixes, breaking the classic 260-character limit for rock-solid nested directory renaming.

09

Ctrl+Z Snapshot Atomic Undo System

Even if you apply an incorrect rule by mistake, KyteRename provides an ironclad fail-safe mechanism:

Three Pillars of the Snapshot Architecture:

  • • Instant Millisecond Rollback: Press Ctrl+Z anytime to roll back immediately along the exact reverse path.
  • • Cross-Session Persistent Logs: Snapshots are preserved locally in JSON format. Even if you restart your PC, you can invoke the History Dialog to roll back past executions.
  • • Reverse Topological Guarantee: Undo runs strictly adhere to reverse DAG topological orders, guaranteeing zero collision or overwrite during the rollback process.
10

Native Seamless Preview Synergy with KyteView

KyteRename cooperates natively with its sister utility, the instant preview tool KyteView, via local inter-process channels:

Spacebar Instant Content Popups

Select any item in the list and press Space to pop up KyteView for videos, Office documents, or high-res photos instantly.

Focus Retention & Fluid Navigation

While previewing, press ↑ ↓ to switch items. The preview updates instantly while keyboard focus remains locked inside the list.

11

Keyboard Shortcuts & Troubleshooting (FAQ)

Shortcut Function Action Description
Space Toggle KyteView Preview Open / close content preview for the selected file
↑ / ↓ Continuous Navigation Quickly switch items with synchronized preview updates
Ctrl + Z Undo Last Rename Safely restore filenames via reverse-topological snapshot log
Ctrl + F Focus Search Field Jump directly to keyword or regex input fields
Ctrl + A Select All Files Apply batch rules or select all items in one click
Delete Remove from List Remove items from processing list without deleting files
Enter Execute Batch Rename Commit renaming after verifying preview accuracy

Q: Warning states "File is locked" or "Access Denied"?

A: Usually this happens when a file is currently opened and locked by Excel, Word, or media players. Close the locking process and click "Retry"; or select "Skip Locked File" to continue processing the rest.

Q: How do I switch to Dark Mode?

A: In the top menu or settings, navigate to "Settings" ➔ "Appearance Mode" and select "System", "Dark", or "Light" for immediate UI adaptation.

Q: What is the maintenance period for perpetual purchases?

A: Perpetual licenses include one year of free maintenance and bug fixes. If major operating system overhauls (such as major future Windows upgrades) necessitate software refactoring, new versions will be sold separately.

Ready to Turbocharge Your File Organization?

Download KyteRename now and experience true 50ms sub-latency dual-pane comparisons and fail-safe topological batch renaming.