danielmorrisey.com / buffit-mac
A lightweight macOS menu bar app for quickly composing and queuing posts to Buffer.
0
Fork 0

Configure Feed

Select the types of activity you want to include in your feed.

2 1 0

Clone this repository

https://git.vm.fail/danielmorrisey.com/buffit-mac https://git.vm.fail/did:plc:kvqw7cnmeczxn2giq6k5hxil
ssh://git@knot1.tangled.sh:2222/danielmorrisey.com/buffit-mac ssh://git@knot1.tangled.sh:2222/did:plc:kvqw7cnmeczxn2giq6k5hxil

For self-hosted knots, clone URLs may differ based on your setup.


Download tar.gz Download .zip
README.md

Buffit — Buffer Queue Manager for Mac#

A lightweight macOS menu bar app for quickly composing and queuing posts to Buffer.

Features#

  • 🎯 Post directly to Buffer from your menu bar
  • 📸 Upload images instantly to CDN
  • ⌨️ Keyboard shortcut: CMD+ENTER to post
  • 🎨 Choose queue or draft by default
  • ⚡ Fast, simple, and lightweight

Installation#

Option 1: Download & Install (Easiest)#

  1. Download the latest Buffit.dmg from Releases
  2. Open the DMG file
  3. Drag Buffit to Applications folder
  4. Open Applications → Buffit
  5. When you see the security warning:
    • Click Open to approve the app
    • Grant any permissions requested

Option 2: Allow from System Settings#

If you see "Buffit can't be opened because it wasn't signed properly":

  1. Go to System Settings → Privacy & Security
  2. Scroll to Security section
  3. Click Open Anyway next to the Buffit warning
  4. Click Open in the confirmation dialog

Option 3: Terminal (Advanced)#

# Remove quarantine if the app won't open
xattr -d com.apple.quarantine ~/Applications/Buffit.app

Setup#

  1. Get your Buffer API key:

  2. Open Buffit from your menu bar

  3. Paste your API key

  4. Click Connect

Your API key is stored securely on your device (in Keychain) — not sent anywhere else.

Usage#

Quick Post#

  1. Click the pencil icon in the menu bar
  2. Type your post
  3. (Optional) Click Upload Image to add an image
  4. Select channels to post to
  5. Press CMD+ENTER or click post button

Settings#

  • Default for new posts — Queue or Draft
  • Privacy — See what data is shared (Buffer API only)
  • Sign Out — Disconnect your Buffer account

Keyboard Shortcuts#

Shortcut Action
CMD+ENTER Post with default action (Queue/Draft)
Click menu bar Open/focus app

Privacy & Security#

  • ✅ API key stored in macOS Keychain
  • ✅ No tracking or analytics
  • ✅ Direct connection to Buffer API only
  • ✅ Open source (all code visible)

Build from Source#

# Clone the repo
git clone https://github.com/yourusername/BufferQueue.git
cd BufferQueue

# Open in Xcode
open BufferQueue.xcodeproj

# Build & Run
# Product → Run (or press ⌘R)

Troubleshooting#

"App won't open"

  • Go to System Settings → Privacy & Security
  • Click "Open Anyway" next to Buffit
  • Or run: xattr -d com.apple.quarantine ~/Applications/Buffit.app

"API key won't save"

  • Make sure you're entering the full API key from Buffer
  • Check that the key hasn't expired in Buffer settings

"Images won't upload"

  • Verify your CDN endpoint is configured correctly
  • Check that the image file isn't corrupted

Requirements#

  • macOS 12.0 or later
  • Buffer account with API access

License#

MIT License — See LICENSE file for details

Support#

Found a bug? Have a feature request?

Made with ❤️ by Daniel Morrisey