Skip to content

elipsoid-cz/OneUp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OneUp for Finder

A tiny macOS app that adds a Go Up button to the Finder toolbar — one click to navigate to the parent folder, just like ⌘↑.

OneUp toolbar button

Features

  • Native Finder toolbar button that fits the macOS visual style
  • Works in every folder — no configuration needed
  • Replicates ⌘↑ exactly: navigates the current window, no new tabs
  • Works in Open / Save dialogs (same extension, separate instance)
  • Zero background processes — the extension is loaded on demand by macOS
  • Sandboxed extension, open source, MIT license

Requirements

  • macOS 13 Ventura or later

Installation

Option A — Download (recommended)

  1. Download OneUp-latest.dmg from Releases
  2. Open the DMG and drag OneUp.app to your /Applications folder
  3. Launch OneUp and click Open Extensions Settings
  4. Enable OneUp under General → Login Items & Extensions → Finder Extensions
  5. In Finder, choose View → Customize Toolbar… and drag the Go Up button wherever you like

Gatekeeper warning: OneUp is not yet signed with an Apple Developer certificate. On first launch macOS may block it. Right-click the app → OpenOpen Anyway, or run:

xattr -cr /Applications/OneUp.app

Option B — Build from source

git clone https://github.com/elipsoid-cz/OneUp.git
cd OneUp
brew install xcodegen        # skip if already installed
xcodegen generate
open OneUp.xcodeproj

Then build and run the OneUp scheme in Xcode (⌘R). Sign in with your Apple ID if prompted.

Uninstall

Open OneUp and click Uninstall OneUp… at the bottom of the window. This deletes the helper script, restarts Finder, and moves the app to Trash.

Alternatively, just delete /Applications/OneUp.app — the extension is removed automatically along with the app.

How it works

OneUp uses the Finder Sync Extension API — the only Apple-supported way to add buttons to the Finder toolbar. When you click the button:

  1. The extension runs an AppleScript via NSUserAppleScriptTask that tells Finder's front window to navigate to parent of target
  2. macOS prompts for Automation permission on the first click — after that it works silently

The main app (OneUp.app) is only needed during initial setup. Once the extension is enabled it runs independently and the main app can be quit.

macOS Sequoia note

macOS 15.0–15.1 temporarily removed the Finder Extensions UI from System Settings (fixed in 15.2). If you are on 15.0 or 15.1, enable the extension via Terminal:

pluginkit -e use -i io.github.oneup-app.OneUp.Extension

Contributing

Pull requests are welcome. To regenerate the Xcode project after editing project.yml:

xcodegen generate

Regenerate app icon

python3 scripts/generate_icon.py

License

MIT — see LICENSE

About

macOS Finder toolbar button to navigate to parent folder (⌘↑)

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors