pawelorzech/qstatus
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
qstatus/README.md
Paweł Orzech c27437b33c
Initial implementation of qStatus macOS menubar app 
Native macOS app for posting to Mastodon, WordPress (self-hosted), and Micro.blog.
Features: global hotkey (Ctrl+Option+Cmd+T), multiple accounts with selection,
image attachments (up to 4, drag-and-drop), floating panel UI, Keychain storage.
2026-02-27 23:40:51 +01:00

1.7 KiB
Raw Blame History

qStatus

A fast, minimalistic macOS menubar app for posting statuses to Mastodon, WordPress, and Micro.blog.

Features

  • Global hotkey (Ctrl+Option+Cmd+T) to instantly open the posting window
  • Multiple accounts -- post to Mastodon, WordPress (self-hosted), and Micro.blog
  • Image attachments -- drag-and-drop or browse, up to 4 images
  • Multi-post -- select one or more accounts and post simultaneously
  • Menubar app -- lives in your menubar, no Dock icon
  • Lightweight -- native Swift/SwiftUI, no Electron, no web views

Requirements

  • macOS 15 Sequoia or later

Installation

Build from Source

  1. Install XcodeGen: brew install xcodegen
  2. Clone this repo
  3. Run xcodegen generate in the project root
  4. Open qStatus.xcodeproj in Xcode
  5. Build and run (Cmd+R)

Setting Up Accounts

Mastodon

  1. Open Settings from the menubar icon
  2. Click + and select Mastodon
  3. Enter your instance URL (e.g., mastodon.social)
  4. You'll be redirected to your instance to authorize qStatus

WordPress (Self-Hosted)

  1. In your WordPress admin, go to Users > Profile > Application Passwords
  2. Create a new application password for "qStatus"
  3. In qStatus Settings, add a WordPress account with your site URL, username, and the application password

Micro.blog

  1. Go to micro.blog/account/apps
  2. Generate a new app token
  3. In qStatus Settings, add a Micro.blog account with the token

Usage

  1. Press Ctrl+Option+Cmd+T (or click the menubar icon > New Post)
  2. Select which account(s) to post to
  3. Type your status
  4. Optionally drag-and-drop images (up to 4)
  5. Press Cmd+Enter or click Post

License

MIT