c27437b33c
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.
56 lines
1.7 KiB
Markdown
56 lines
1.7 KiB
Markdown
# 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](https://github.com/yonaskolb/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](https://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
|