Skip to content

gingerbeardman/stapler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Stapler

My take on classic Macintosh app Stapler (Chris Patterson, Patterson Software Works, 1992).

With a little bit of the early Mac OS X app LaunchList (Ali Rantakari, hasseg.org, 2009).

What is it?

The idea is you set up a Stapler Document per project containing related apps, files, folders, etc.

Then you can open them all at once by launching the single Stapler Document.

Each Stapler Document contains lists of aliases which can be managed, inspected and launched through Stapler.app.

screenshot

Use cases

  • Work: open Nova editor, run current game, pixel art editor, bitmap font app, Taskpaper todo list
  • Play: Music app, Hacker News app, Twitter app
  • Movie: run Caffeine to keep your computer on, shortcut to Sleep Displays

Download

https://github.com/gingerbeardman/stapler/releases/latest


Usage

Opening the app

  • The app is digitally signed by me and my Apple developer account
  • The app is not Notarised and I currently have no plans to do so
  • You may need to do the right-click-choose-open Gatekeeper dance a couple of times to open it

Editing a list

  1. Open Stapler.app
  2. Create a New Document
  3. Add some items
    • using drag and drop from Finder or other apps
    • or using the menu Items > Add
  4. Items can be removed (they are aliases so files on disk are not affected)
  5. Save your list as a Stapler Document

All standard macOS Document-Based App conventions are supported through the File menu. And things like Undo just works!

Launching a list

  1. Open your Stapler Document
  2. All items in the list will be launched automatically
  3. Stapler.app will close (if it was not already open)

Tip: hold the Cmd key as the Stapler Document is being launching to open it in edit mode.

Launching specific items

  1. Open Stapler.app
  2. Open a Stapler Document
  3. Select the items you want to launch
  4. Select Items > Launch (or press Return)

Working with a list

  1. Open Stapler.app
  2. Open a Stapler Document
    • use File > Open…
    • use File > Open Recent
  3. Use the Items menu

Keyboard controls

Key Function
Cmd + Return Add… (open file selector)
Backspace Remove
Space Quick Look
Cmd + R Reveal in Finder
Return Launch

Permissions

  • All files you select or drop are recorded only as system bookmarks
  • The only files that are written are through the file save selector
  • Read-only permission may be prompted for some folders
  • Network permission is required to Quick Look .webloc files