Emacs: Find Replace Text in Directory

By Xah Lee. Date: . Last updated: .

Suppose you want to do find and replace, for hundreds of files in a directory, either in one shot, or asking yes/no for each occurrence.

Here's the solution.

Select Target Directory

Alt+x dired, then type a directory path, to list a directory.

Press ^ to go up a directory.

Now, your cursor should be on the directory you want to do the find/replace.

emacs dired find replace dir 2017 06 24
emacs dired

Select Only Some Files

If you want to find/replace only files ending in “.html”, or “.js”, or other selections of files, you need to mark files.

Mark Files/Directories

emacs dired marked files 2017 06 d830f
emacs dired marked files

Mark Files by Regex

Alt+x dired-mark-files-regexp% m

then type your regex pattern.

For example, if you want to mark all files ending in “.html”, then type 【% m】 then \.html$.

[see Emacs: Regex Tutorial]

Interactive Find Replace

Alt+x dired-do-query-replace-regexpQ】.

Answer the prompt, by typing find regex string and replace string.

For example, type “queen” Enter then “princess”, to replace words “queen” by “princess”.

[see Emacs: Regex Tutorial]

The Result Window

Emacs will show result, in a split window.

emacs dired do query replace regexp 2017 06 96227
emacs dired-do-query-replace-regexp result. Note the prompt at bottom.

The top pane, is a file where a match is found. Cursor is place on the word.

The bottom pane shows a list of files where match is found. This buffer is name “*xref*”.

In the top pane showing the actual file, the following keys are available:

If you want to cancel the whole operation without saving any changes you've made, type 【Ctrl+g】, then exit emacs.

Result Overview: xref buffer

The bottom pane buffer named “*xref*”, lists all the occurrences and files.

Move cursor to the “*xref*” pane, then the following keys are available:

Enter → Display the reference on the current line.

n or . → Move to the next reference and display it in the other window (xref-next-line).

p or , → Move to the previous reference and display it in the other window (xref-prev-line).

Ctrl+o → Display the reference on the current line in the other window (xref-show-location-at-point).

r → prompt for find replace with regex. (xref-query-replace-in-results)

q → Quit the window showing the *xref* buffer. (quit-window)

In the xref buffer, Alt+x describe-mode to see the doc.

(info "(emacs) Xref Commands")

Save Changed Files

Alt+x ibuffer to list all opened files.

  1. Type 【* u】 to mark all unsaved files
  2. type S to save all marked files
  3. type D to close them all.

Alternative to the above options, Alt+x save-some-buffersCtrl+x s】. Then emacs will display each unsaved file and ask if you want it saved.

Alternative, xah-find.el

Emacs requires the unix grep command installed. On Microsoft Windows, you need to install it.

Alternatively, try

Emacs: xah-find.el, Find Replace in Pure Elisp

It does not require grep, is easier to use, and provides other features.

Dired topics

  1. Emacs: File Manager, dired
  2. Emacs: Dired Customization
  3. Emacs: Find Replace Text in Directory
  4. Emacs: Batch Rename Files
  5. Emacs: Dired Sort File by Time, Size
  6. Emacs: Open File in External App
  7. Emacs: Rename File from Space to Hyphen/Underscore
  8. Emacs: Convert Image Files in Dired

Find and Replace Topic

  1. Emacs: Search / Highlight Word
  2. Emacs: Search Text in Files
  3. Emacs: Find and Replace Commands
  4. Emacs: Find Replace Text in Directory
  5. Emacs: Regex Tutorial
  6. Emacs: isearch Current Word
  7. Emacs: xah-find.el, Find Replace in Pure Elisp
Patreon me $5 patreon

Or Buy Xah Emacs Tutorial

Or buy a nice keyboard: Best Keyboard for Emacs

If you have a question, put $5 at patreon and message me.