Home
How to Convert Folder Contents Into a Single Text File on Windows and Mac
Technically, a folder and a text file are two fundamentally different data structures. A folder is a container that organizes other files, while a .txt file is a single document containing characters. You cannot "convert" the physical folder structure itself into a text document in the same way you convert a Word file to a PDF.
However, most users asking this question want one of two things: either a list of file names contained within that folder or a single text file that merges the actual content of every file inside that folder. The latter has become extremely popular recently for developers who need to feed an entire codebase into an AI model like ChatGPT or Claude for analysis.
Fast Method for Generating a File List
If you only need a list of the names of the files inside a folder, you can use built-in system tools without downloading any additional software.
Generating a Folder List on Windows (Command Prompt)
Windows provides the dir command, which is highly efficient for directory listing.
- Open File Explorer and navigate to the folder you want to document.
- Click on the address bar at the top, type
cmd, and press Enter. This opens the Command Prompt directly in that directory. - Type the following command:
dir /b > list.txt - Press Enter. A new file named
list.txtwill appear in your folder containing all the file names.
Understanding the command:
dir: The command to list directory contents./b: Stands for "bare" format. It removes extra information like file size, time stamps, and headers, giving you just the names.> list.txt: This is a redirection operator. Instead of showing the list on your screen, it "pipes" the data into a new file.
If you want to include files within all subfolders as well, use the recursive flag:
dir /b /s > full_list.txt
Generating a Folder List on macOS (Terminal)
On macOS, the process is similar but uses the ls command, which is the Unix standard for listing files.
- Open Terminal (Cmd + Space, then type "Terminal").
- Type
cd(with a space at the end), then drag the folder from Finder into the Terminal window to paste the path. Press Enter. - Type the following command:
ls -R > list.txt - Press Enter. The
-Rflag stands for recursive, which will list everything in the main folder and its subdirectories.
How to Merge Folder Contents into One Text File
This is a more advanced requirement. It involves taking the text inside every file in a folder and stitching it all together into one giant .txt file. This is the "gold standard" for creating context files for Large Language Models (LLMs).
Using Windows PowerShell (The Most Efficient Way)
PowerShell is significantly more powerful than the old CMD for this task because it handles modern text encoding better.
- Navigate to your folder in File Explorer.
- Hold Shift and Right-click in an empty space, then select Open PowerShell window here.
- Copy and paste the following command:
Get-ChildItem -Recurse -File | ForEach-Object { "--- FILE: $($_.FullName) ---"; Get-Content $_.FullName; "n" } | Out-File -FilePath "combined_project.txt" -Encoding utf8`
Why this command is superior:
In our testing, simple concatenation often fails when files use different encodings. This script explicitly adds a header (e.g., --- FILE: C:\Users\Project\index.js ---) before each file's content so that you—or an AI—can tell where one file ends and the next begins. It also forces UTF-8 encoding, which prevents garbled text if your files contain special characters or emojis.
Using macOS/Linux Bash
On a Mac, you can use the cat command (short for concatenate).
- Open Terminal in your target folder.
- Run this command:
find . -type f -name "*" -print -exec cat {} \; > combined.txt
This command finds every file (-type f), prints its name, and then uses cat to dump its contents into combined.txt. However, be aware that this will include binary files (like images or PDFs) if they are in the folder, which will result in "junk" text inside your TXT file.
Specialized Tools for AI and Large Codebases
If you are a developer trying to "make a folder into a txt" for AI context, manual commands can sometimes be messy. Several specialized tools handle filtering (like ignoring .git or node_modules folders) automatically.
folder-to-text (NPM Utility)
For those comfortable with Node.js, folder-to-text is a highly refined tool. It doesn't just merge files; it creates a structured document optimized for Claude and ChatGPT.
- Installation:
npm install -g folder-to-text - Usage:
ftt convert ./my-project -o output.txt - Advantage: It automatically excludes large binary files and common "junk" folders, saving you thousands of tokens in your AI prompts.
Python Scripting for Custom Merging
If you need specific control—for example, only merging .py and .md files—a short Python script is the most reliable method.
-
Topic: GitHub - katio/folder2txt: Convert folder file contents to text to assist conversations with large language models like ChatGPT, Claude, Gemini, etc. · GitHubhttps://github.com/katio/folder2txt
-
Topic: GitHub - ARZUCODER/folder_to_txt: Tiny desktop utility that merges a whole folder into one .txt — great for feeding a codebase to AI. · GitHubhttps://github.com/ARZUCODER/folder_to_txt
-
Topic: Save Folder Structure and Text Code in a Single Text File by Running A Batch File in Windows 10 or 11 – Noteshttps://aatayyab.wordpress.com/2025/10/27/save-folder-structure-and-text-code-in-a-single-text-file-by-running-a-batch-file-in-windows-10-or-11/