Replace INFO with AI Description

Filename Tool uses -INFO- as a placeholder for descriptive content that can be added after files have been renamed. A vision-capable AI can review those files and propose a short description to replace each INFO component. The hyphens surrounding INFO should not be replaced.

Example

From:

To:

emphasis added; not part of the filename

Instructions for People

1. Give your AI this documentation URL:

2. Point the AI to the folder containing your already-renamed images and videos. Depending on how it is configured, an AI may be able to read a directory after you grant permission or it may require you to upload the files. If you need to upload the files, review your service’s privacy and retention terms first if you care about such things.

3. Ask the AI to follow the prompt below. It should return a script. Review and edit the script before executing it within the folder containing the files. The script is only a proposal; the AI should not execute it, only you should. The returned script is usually a Bash file. If you’re using Windows, you may optionally request a PowerShell script. Scripts are designed to be pasted directly into a Bash terminal or a PowerShell console, respectively.

The AI will ordinarily use neutral descriptions such as Woman_with_Pelicans_in_Background. If you want a known person's name in the descriptions, tell the AI who that person is when you provide this prompt. Otherwise, replace generic terms with names yourself either while reviewing the script or when editing the changed filenames afterward.

Prompt for the AI

Review the photo and video files I have made available to you. Their filenames were already created with FilenameTool.com, but some still contain INFO as an exact hyphen-delimited filename component.

The product you are creating is a proposed rename script to rename files by only replacing the INFO string in just the files containing -INFO- with descriptions you’ve written. Create a proposed rename script using these rules. Bash is the default. If I explicitly request PowerShell, return a PowerShell script instead.

1. Process only filenames containing -INFO- as a complete filename component with case sensitive. Skip any other filename. The string to be replaced is only INFO; leave the hyphens untouched.

2. Visually inspect every matching photo. For a matching video, inspect representative frames from the beginning, middle, and end.

3. Replace only the INFO string. Copy every other character of the filename verbatim from the original filename, including capitalization, punctuation, spaces, dates, times, credits, devices, sequence numbers, flags, dimensions, and extensions. Never reconstruct or normalize any portion of the filename.

4. Replace the INFO string with a concrete description of the main visible subject or action, normally three to seven words with a maximum of ten words. Use Title_Case with words separated by underscores, for example Rocks_Road_and_Fence. Do not use illegal filename characters ( : ; ~ & * \ " ' ? [ ] { } ( ) < > ␣ ), periods, or commas. Spaces should always be replaced with underscores. Only replace the INFO string; the rest of the proposed filename should be character by character identical to the original filename.

5. Use neutral descriptions for people unless I have explicitly identified them. Never guess identity, relationships, sensitive traits, ownership, or an exact location. If a name has been provided, use the full name as provided; if a first and last name was provided, use both the first and last name.

6. Make descriptions for similar files distinct whenever the visible content truthfully supports a distinction. If the content is unclear, leave the filename unchanged, do not replace the INFO string for that filename, and report that filename for manual review rather than inventing a description.

7. Before producing the script, verify all of the following:

	* every matching filename was processed exactly once;
	
	* every original filename exactly matches an existing filename;
	
	* every proposed filename differs from its original only by the replacement of the INFO component;
	
	* no proposed filename duplicates another proposed filename;
	
	* no proposed filename conflicts with an existing filename in the same directory.

8. Return only a code block containing the rename commands. The code block must only contain commands ready to paste into the Terminal, other than an initial commented line that says: “# Change to Chosen Directory before pasting these commands.” Otherwise, do not include a shebang, comments, blank lines, prompts, explanatory text, Markdown, or any other content inside the code block.

9. Unless I explicitly request PowerShell, produce Bash commands. Every command must appear exactly in this form:

	mv 'original filename' 'proposed filename';

10. If I explicitly request PowerShell, use a PowerShell code block instead, with each command in exactly this form:

	Rename-Item -LiteralPath 'original filename' -NewName 'proposed filename';

11. Use only plain ASCII characters for shell syntax although the filename can contain non-ASCII characters. Do not use typographic (“smart”) quotes, Unicode dashes, or other punctuation substitutions. Use the ASCII apostrophe (') for shell quoting.

12. Correctly escape any apostrophes or other special characters inside filenames for the selected shell. Use filenames relative to the current directory. In Bash, safely single-quote each filename. In PowerShell single-quoted strings, represent an apostrophe with two apostrophes. Use filenames relative to the directory containing the files. Do not overwrite files and do not execute any command.

13. Put a hard return after every command, including the last command, so the code block ends with a newline.

14. If any filename cannot be renamed safely, omit it from the script, and list it separately after the code block for manual review.

15. The product you are creating is the renaming script with the descriptions you've written replacing the INFO string in files containing -INFO-.

Running the Script

Your AI should return a Bash or PowerShell script. Before running the script, review every proposed filename. Correct generic descriptions, names, places, species, spelling, and any subjective or unsupported wording. Confirm that each command changes only INFO and that none of the proposed filenames already exists.

Duplicate the folder of files to keep as a temporary backup. After approving the script, change your Bash Terminal or PowerShell session to the folder containing the files and paste the commands to rename the files.