FindUtils Cheatsheet: Every Command for Linux, macOS & Windows (+ Web Alternatives)

GNU findutils is the backbone of file searching and batch processing on Linux and Unix systems. The package includes four core commands — find, locate, updatedb, and xargs — that handle everything from locating files by name to executing complex batch operations across thousands of files. This cheatsheet covers every major use case across Linux, macOS, and Windows, plus a mapping to free web-based alternatives at findutils.com for when you need a browser-based solution.

Whether you're a sysadmin hunting down rogue log files, a developer cleaning up build artifacts, or a security engineer auditing file permissions — this is your single reference for all findutils operations.

What Is GNU Findutils?

GNU findutils is a collection of four command-line utilities that search for and process files on Unix-like operating systems. Every major Linux distribution includes findutils by default, and macOS ships with BSD versions of the same commands. Here's what each command does:

Installing Findutils by Platform

Findutils comes pre-installed on most systems, but here's how to install or update it on each platform.

Linux

sudo apt install findutils

# Fedora/RHEL
sudo dnf install findutils

# Arch Linux
sudo pacman -S findutils

# Check version
find --version

macOS

macOS ships with BSD find, which has slightly different flags. To get GNU findutils (recommended for full compatibility):

# Install via Homebrew
brew install findutils

# GNU versions are prefixed with 'g'
gfind --version    # GNU find
gxargs --version   # GNU xargs
glocate --version  # GNU locate

Tip: Add GNU findutils to your PATH to use them without the g prefix:

export PATH="/opt/homebrew/opt/findutils/libexec/gnubin:$PATH"

Windows

# Option 1: WSL (Windows Subsystem for Linux)
wsl sudo apt install findutils

# Option 2: Git Bash (ships with find and xargs)
# Already included — just open Git Bash

# Option 3: Cygwin
# Select findutils during Cygwin setup

# Option 4: MSYS2
pacman -S findutils

# Windows native equivalent
where /R C:\ filename.txt       # Similar to find -name
dir /S /B *.txt                  # Recursive file listing

The find Command — Complete Cheatsheet

The find command is the most powerful and versatile tool in findutils. It searches the filesystem in real-time, applying filters and executing actions on matches.

Basic Syntax

find [path] [options] [expression]

Finding Files by Name

Finding Files by Type

Finding Files by Size

Size suffixes: c (bytes), k (kilobytes), M (megabytes), G (gigabytes)

Finding Files by Time

Time units: -mtime (days), -mmin (minutes), -atime (access time), -ctime (change time)

Finding Files by Permissions and Ownership

Finding Files by Depth

Executing Actions on Found Files

This is where find becomes incredibly powerful — executing commands on every match.

Excluding Directories

Combining Conditions

Advanced find Recipes

# Find duplicate files by size (potential duplicates)
find . -type f -exec ls -lS {} + | awk '{print $5, $NF}' | sort -n | uniq -d -w 10

# Find and count files by extension
find . -type f | sed 's/.*\.//' | sort | uniq -c | sort -rn | head -20

# Find files modified today
find . -type f -daystart -mtime 0

# Find broken symlinks
find . -xtype l

# Find largest 10 directories
find . -type d -exec du -sh {} + 2>/dev/null | sort -rh | head -10

# Find world-writable files (security audit)
find / -type f -perm -0002 -ls 2>/dev/null

# Find files with specific content and replace
find . -name "*.txt" -exec sed -i 's/old/new/g' {} +

# Find recently modified config files
find /etc -name "*.conf" -mmin -30 -type f

The locate Command — Fast File Search

The locate command searches a pre-built database of filenames, making it 10-100x faster than find for simple name searches. The tradeoff: it doesn't see files created since the last database update.

Basic Usage

macOS Differences

macOS uses a different locate implementation:

# Update the database on macOS
sudo /usr/libexec/locate.updatedb

# Or with GNU locate (from Homebrew findutils)
gupdatedb
glocate filename

Windows Equivalent

Windows doesn't have locate, but you can use:

# Windows Search from command line
where /R C:\ *.json

# PowerShell equivalent
Get-ChildItem -Path C:\ -Recurse -Filter "*.json" -ErrorAction SilentlyContinue

# Using Everything (third-party, very fast)
es.exe "*.json"

The updatedb Command — Database Maintenance

updatedb rebuilds the file database used by locate. Most systems run it automatically via a daily cron job.

Configuration File

The default configuration is at /etc/updatedb.conf:

# Common /etc/updatedb.conf settings
PRUNE_BIND_MOUNTS="yes"
PRUNEPATHS="/tmp /var/spool /media /mnt"
PRUNEFS="NFS nfs nfs4 rpc_pipefs afs binfmt_misc"

The xargs Command — Batch Command Builder

xargs reads items from standard input and executes a command with those items as arguments. It's the glue that makes find pipelines truly powerful.

Basic Usage

Handling Filenames with Spaces

This is the #1 gotcha with xargs. Always use null-delimited input for safety:

# SAFE: Use -print0 and -0 together
find . -name "*.txt" -print0 | xargs -0 rm

# SAFE: Use -I with placeholder
find . -name "*.txt" | xargs -I {} mv {} /backup/

# UNSAFE: Will break on spaces in filenames
find . -name "*.txt" | xargs rm   # DON'T DO THIS

xargs Flags Reference

Advanced xargs Recipes

# Parallel file compression (8 cores)
find . -name "*.log" -print0 | xargs -0 -P 8 gzip

# Batch rename files
find . -name "*.jpeg" | xargs -I {} bash -c 'mv "$1" "${1%.jpeg}.jpg"' _ {}

# Download URLs in parallel
cat urls.txt | xargs -P 5 -I {} wget -q {}

# Count lines in all Python files
find . -name "*.py" | xargs wc -l | tail -1

# Run eslint on changed files only
git diff --name-only -- '*.js' | xargs eslint

# Batch image resize with ImageMagick
find . -name "*.png" -print0 | xargs -0 -P 4 -I {} convert {} -resize 50% {}

Cross-Platform Comparison Table

Not every command works the same on every OS. Here's a quick reference:

CLI Commands vs FindUtils.com Web Tools

Many operations that traditionally require find + command-line tools can now be done instantly in the browser. This table maps common find + exec/xargs pipelines to their free web-based equivalents on findutils.com — no terminal required.

File Format Processing

Data Conversion

Security & Hashing

Image & Media Processing

Text Analysis

PDF Operations

Developer Workflows

When to Use CLI vs Web Tools

Both command-line findutils and browser-based tools have their place. Here's a decision matrix:

FindUtils.com processes everything client-side in your browser — nothing is uploaded to servers. This makes web tools a safe choice even for sensitive data like API keys, configuration files, or private documents.

Common Mistakes and How to Fix Them

Mistake 1: Forgetting Quotes Around Patterns

# WRONG — shell expands the glob before find sees it
find . -name *.txt

# CORRECT — quotes prevent premature expansion
find . -name "*.txt"

Mistake 2: Using xargs Without Null-Delimiter on Files with Spaces

# WRONG — breaks on "My Document.txt"
find . -name "*.txt" | xargs rm

# CORRECT — null-delimited, handles any filename
find . -name "*.txt" -print0 | xargs -0 rm

Mistake 3: Using -exec with ; When + Is Faster

# SLOW — spawns one process per file
find . -name "*.log" -exec grep "error" {} \;

# FAST — batches files into fewer processes
find . -name "*.log" -exec grep "error" {} +

Mistake 4: Forgetting -prune and Searching Unnecessary Directories

# SLOW — searches inside .git, node_modules, etc.
find . -name "*.js"

# FAST — skips heavy directories
find . -path ./node_modules -prune -o -path ./.git -prune -o -name "*.js" -print

Mistake 5: Running updatedb Without Proper Exclusions

# BAD — indexes /tmp, /proc, network mounts
sudo updatedb

# GOOD — exclude transient and network paths
sudo updatedb --prunepaths="/tmp /proc /sys /mnt /media /run"

Quick Reference Card

Copy this section and pin it to your terminal:

# =================== FIND ESSENTIALS ===================
find . -name "*.ext"              # Find by name
find . -iname "*.ext"             # Case-insensitive
find . -type f -size +100M        # Large files
find . -mtime -7 -type f          # Modified last 7 days
find . -name "*.tmp" -delete      # Delete matches
find . -name "*.js" -exec CMD {} + # Execute on matches
find . -print0 | xargs -0 CMD    # Safe piping

# =================== LOCATE ESSENTIALS ==================
sudo updatedb                     # Refresh database
locate -i "filename"              # Fast case-insensitive search
locate -c "*.pdf"                 # Count matches
locate -r '\.conf$'               # Regex search

# =================== XARGS ESSENTIALS ===================
find . -print0 | xargs -0 CMD    # Null-safe execution
cmd | xargs -I {} echo {}        # Placeholder mode
cmd | xargs -P 4 -n 1 CMD        # 4 parallel processes
cmd | xargs -p CMD                # Prompt before each

Tools Used in This Guide

• JSON Formatter — Format and beautify JSON with syntax validation
• JSON Comparer — Visual side-by-side JSON comparison
• JSON Diff — Highlight differences between two JSON files
• Regex Tester — Test and debug regex patterns with real-time matching
• Diff Checker — Compare any two text files or code snippets
• Word Counter — Count words, characters, sentences, and paragraphs
• CSV to JSON — Convert CSV data to JSON format instantly
• HTML Formatter — Pretty-print and indent HTML code
• MD5 Hash Generator — Generate MD5 hashes for text or files
• Image Resizer — Resize images with preset or custom dimensions
• Image Compressor — Reduce image file size without visible quality loss
• PDF Merger — Combine multiple PDFs into one document
• EXIF Remover — Strip metadata from photos for privacy
• jq Playground — Query and transform JSON with jq expressions
• JSON to TypeScript — Generate TypeScript interfaces from JSON data

FAQ

Q1: What is GNU findutils? A: GNU findutils is a package of four command-line utilities — find, locate, updatedb, and xargs — used to search for files and execute batch commands on Unix-like operating systems. It comes pre-installed on virtually every Linux distribution and is available for macOS via Homebrew and Windows via WSL or Git Bash.

Q2: What is the difference between find and locate? A: find searches the filesystem in real-time by traversing directories, making it slower but always up-to-date. locate searches a pre-built database of filenames, making it 10-100x faster but potentially missing recently created files. Use updatedb to refresh the locate database.

Q3: Does macOS have findutils? A: macOS ships with BSD versions of find and xargs, which have slightly different flags than GNU versions. To get full GNU findutils compatibility, install via Homebrew with brew install findutils. The GNU versions are available as gfind, glocate, gupdatedb, and gxargs.

Q4: How do I use find on Windows? A: Windows doesn't include GNU findutils natively. Your best options are: WSL (Windows Subsystem for Linux) which gives you full Linux commands, Git Bash which includes find and xargs, or PowerShell's Get-ChildItem cmdlet which provides similar functionality. For a no-install alternative, findutils.com offers 250+ free browser-based tools for file processing.

Q5: Is findutils.com related to GNU findutils? A: FindUtils.com (findutils.com) is a website offering 250+ free browser-based utility tools that accomplish many of the same tasks as GNU findutils command-line pipelines — such as formatting JSON, converting file formats, hashing data, and processing images — without requiring a terminal. All processing happens client-side in your browser for maximum privacy.

Q6: How do I handle filenames with spaces in find and xargs? A: Always use the -print0 flag with find and the -0 flag with xargs. This uses null characters instead of newlines as delimiters, safely handling any filename regardless of spaces or special characters: find . -name "*.txt" -print0 | xargs -0 rm.

Q7: What is the fastest way to find files on Linux? A: For one-time searches, use locate (after running updatedb) — it's 10-100x faster than find because it queries a database. For searches that need to be 100% current or apply complex filters (size, permissions, modification time), use find. For web-based file processing without any command-line setup, use the free tools at findutils.com.

Next Steps

• Complete Guide to Online Developer Tools — Explore 60+ developer tools available in your browser
• How to Compare and Diff Code Files — Master file comparison techniques
• Complete Guide to Online JSON Tools — Deep dive into all JSON processing tools
• How to Format and Beautify Code Online — Format any code language instantly
• Complete Guide to Online Security Tools — Hash, encrypt, and audit with browser-based tools