Skip to content
Projects

mariusgm/newfile has 87 GitHub stars and 5 forks. GitHot measured +4 stars in 24 hours, +9 in 7 days, and +13 in 15 days. Last checked 2026-11-15 20:35 UTC. Last push 2026-11-05.

How these counts are measured

87 stars5 Forks +4 in 24h

Measured star growth

in 24h
+4
in 7 days
+9
in 15 days
+13
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

The missing 'New File' button for macOS Finder — customizable file types, per-type starter templates. Free, open-source Finder Sync Extension. brew install --cask mariusgm/newfile/newfile or DMG.

Productivity

README.md

Original

NewFile — New File button for macOS Finder

Free, open-source, native. A small Finder Sync Extension that adds the missing "New File" button to macOS Finder — right-click menu and toolbar. No Automator, no shell scripts, no setup beyond enabling the extension once.

  • Any file type — .txt enabled by default, plus 7 built-in presets (.md, .json, .sh, .env, .yml, .gitignore, .html). Add your own (.tsx, .toml, whatever you need).
  • Starter templates — pre-fill new files with frontmatter, shebang lines, a JSON skeleton, or any boilerplate you reuse.
  • Drag-to-reorder — set the menu order in Preferences; the first enabled type is the toolbar's one-click action.
  • Submenu mode — optionally collapse all types under a single "New File ▸" right-click entry.
  • Auto-incrementing names — New Text File.txt, then New Text File 2.txt, and so on. Reveals and selects the new file.
  • Auto-updates via Sparkle — no need to re-download.

macOS Finder lets you create a New Folder but not a New File. NewFile fixes that — the way it should have shipped.

NewFile demo — right-click in Finder to create a new file

Install

Homebrew (recommended)

brew install mariusgm/newfile/newfile

Then launch NewFile once (open -a NewFile). macOS only registers the Finder extension after the app's first launch — until then the toggle below won't appear.

Manual

  1. Download the latest NewFile.dmg from Releases.
  2. Drag NewFile.app to /Applications.
  3. Launch it once. Follow the in-app instructions to enable the Finder extension.

Enable the Finder extension (one time)

NewFile must have been launched at least once first.

Open System Settings → General → Login Items & Extensions, then:

  • macOS 27 "Golden Gate": under Extensions, choose By Category, click the ⓘ next to File Providers, and turn on NewFile. macOS lists NewFile there rather than under Finder.
  • macOS 26 and earlier: scroll to Added Extensions and toggle NewFile Extension.

On macOS Sequoia 15.0 and 15.1 the Extensions UI was buggy — update to 15.2 or later if NewFile Extension doesn't appear in the toggle list.

If NewFile doesn't appear under File Providers on macOS 27, please open an issue.

Add the toolbar button

In any Finder window: View → Customize Toolbar… → drag the NewFile icon into the toolbar where you want it.

Use it

  • Toolbar button: click → menu pops with "New Text File" → click → file created and selected.
  • Right-click: anywhere in a Finder window background → "New Text File".

The created file is named New Text File.txt. If that name exists, it becomes New Text File 2.txt, then New Text File 3.txt, and so on.

iCloud Drive: use the toolbar button

On recent macOS versions, Finder doesn't show right-click items from third-party Finder extensions inside iCloud Drive folders — including Desktop and Documents when they sync to iCloud. Finder Sync extensions were designed around a folder each extension owns, and iCloud Drive manages these folders itself (Apple Developer Forums). Other Finder Sync apps report the same behavior. We haven't identified a supported Finder Sync workaround that restores the right-click menu there. The toolbar button works in iCloud Drive — add it once (above) and use it there.

Customize

Open NewFile.app → ⌘, (or click the toolbar dropdown → Customize…) to manage file types, templates, menu order, and submenu mode. Each type has an editable menu label (what Finder shows) and a default filename; leave the filename empty for dotfile-style names (.env, .gitignore). A Rich Text (.rtf) type ships with a minimal RTF header so the file opens in TextEdit; an empty .rtf isn't a valid RTF document. The Add…/Edit… button per row manages that type's starter template.

Build from source

git clone https://github.com/mariusgm/newfile.git
cd newfile
brew install xcodegen
xcodegen generate
open NewFile.xcodeproj

In Xcode: select the NewFile scheme, ⌘R to build & run. See setup.md for code signing and notarization notes if you want to distribute your own build.

Project layout

newfile/
├── App/                 SwiftUI host app — onboarding window only
├── Extension/           FIFinderSync subclass — toolbar + context menu + file creation
├── project.yml          xcodegen project definition (regenerable)
├── README.md
└── setup.md             codesigning + notarization + release notes

The host app (NewFile.app) is intentionally minimal — its only job is to embed the Finder Sync extension and present onboarding. All the work happens in Extension/FinderSync.swift.

Uninstall

Quitting NewFile doesn't stop the Finder extension — Finder keeps it running as its own process, which is why macOS can say the app is "in use" when you try to delete it.

Homebrew: brew uninstall --cask newfile (add --zap to also remove your saved file types).

Manual (DMG install):

  1. Quit NewFile (⌘Q).
  2. Turn off NewFile in System Settings → General → Login Items & Extensions. The toggle's location depends on your macOS version: see Enable the Finder extension.
  3. Drag NewFile.app from Applications to the Trash.
  4. Optional — remove saved settings: delete ~/Library/Group Containers/Q7VD7MTRL8.dev.newfile.NewFile.

How it works

NewFile is implemented as a Finder Sync Extension (FIFinderSync) — Apple's supported way to add toolbar buttons and context menus to Finder. It runs sandboxed under macOS's app extension model. No private APIs, no SIMBL, no Finder injection.

When you click the toolbar button or context menu item:

  1. The extension reads the targeted folder via FIFinderSyncController.targetedURL().
  2. It picks a unique filename (New Text File.txt, then New Text File 2.txt, etc.).
  3. It creates an empty file with FileManager.createFile.
  4. It calls NSWorkspace.activateFileViewerSelecting to reveal and select the file.

License

MIT — do whatever, no warranty.

Support

NewFile is free and stays free. If it saves you time, you can sponsor its development.

Related