FolderContents

FolderContents: macOS information at a glance

FolderContents shows PNG, MP4, and PDF details in Finder Comments so you can decide what to keep, defer, or trash without opening each folder.
Open Manual View on Mac App Store My Etsy shop Sign up for newsletter
What it can show

One column, useful answers

The clue changes with the file type.

Folderspng:100, pdf:1

Most common file types, without opening the folder.

Imagessize: 1920 x 1080

Pixel dimensions for PNG, JPEG, WebP, AVIF, GIF, TIFF, HEIC, and HEIF.

Audio + videoduration: 3:42

Duration for selected MP3 and MP4 files.

Anki + SQLitenotes:60, cards:60

Useful counts from database files that otherwise reveal almost nothing in Finder.

HTMLtitle:'Order history'

The page title, without opening a browser or source editor.

Documents + datapages: 12 · lines: 100

Page, line, and ZIP file counts at a glance.

Finder comments are a snapshot. If files change, run FolderContents again to refresh the clue.

The app can show TXT first lines and use Ignore, Hoist, and Append example lists. Enable Append License info in Settings when needed; it defaults off. MIT License becomes MIT. The app and Quick Action share this setting through Settings.plist.

Set it once

Watch Downloads, or use it only when needed.

FolderContents can comment new top-level Downloads automatically. The included Finder Quick Action handles selected files and folders on demand.

The legacy Quick Action has separate behavior. PDF and ZIP counts, NDJSON, TXT previews, example lists, and root-marker signals are app features. Drag items onto the app to use them.

  • Runs locally on your Mac
  • No account, upload, or subscription
  • Comments stay attached to Finder items
FolderContents settings showing Downloads watching and supported Finder comment summaries
The settings window stays out of the way; Finder is the main interface.

Advanced · First-slot signals

Some names matter more than their count.

These can look like noise to most people. For developers, makers, and technical teams, each one identifies the kind of folder immediately, so FolderContents recognizes it directly or hoists it ahead of ordinary file types.

SKILL.mdCodex skill
mcp.jsonMCP configuration
CLAUDE.mdClaude Code project instructions
AGENTS.mdCodex agent instructions
DockerfileDocker container image
ContainerfileDocker or Podman container image
*.xcodeprojXcode project
*.xcworkspaceXcode workspace
Package.swiftSwift package
manifest.jsonPackaged app, Chrome extension, or web project
package.jsonJavaScript or Node project
pyproject.tomlModern Python project
setup.cfgPython package configuration
Cargo.tomlRust project
MakefileCommand-line build workflow
PodfileCocoaPods-based Apple project
go.modGo module
requirements.txtPython dependencies
x86_64:1Mac app without Apple silicon support