Skip to content

GoblinRules/quack-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Quack Manager

Quack Manager

A desktop app for managing multiple Quackr.io virtual phone numbers and incoming SMS messages.

Release License


Screenshots

Dashboard

Dashboard with sidebar, inbox, unread badges, and account balance

Notifications

Notification settings with Discord, Slack, and Telegram support

Phone Numbers

Manage phone numbers with custom names, API key assignment, and per-number polling

Desktop Notification

Desktop notifications for incoming SMS

More screenshots

Settings

Tabbed settings with API Keys, Phone Numbers, Polling, Notifications, Account, Webhooks, and Help

Account

Account overview with balance, active numbers, and expiring numbers

Webhooks

Webhook configuration for real-time SMS delivery

Help / About

Help section with links and update checker

Features

  • Unified Inbox - View all SMS messages from all numbers in one place
  • Multi-number management - Add unlimited Quackr.io phone numbers with custom names
  • Multi-API key support - Use different API keys for different numbers
  • Smart polling - Configurable global poll interval with per-number overrides
  • Notifications - Get alerted via:
    • Desktop notifications
    • Discord (webhook or bot)
    • Slack (webhook or bot)
    • Telegram (bot)
  • Account management - View balance, active numbers, expiry warnings, and import numbers directly from Quackr
  • Webhook configuration - Set up webhook URLs for real-time SMS delivery
  • Unread tracking - Badges for unread messages, mark as read, mark all read
  • Search - Filter numbers in the sidebar
  • Dark / Light theme - Toggle between dark charcoal and light themes
  • Update checker - Check for new releases from GitHub

Getting Started

Prerequisites

Installation

git clone https://github.com/GoblinRules/quack-manager.git
cd quack-manager
npm install
npm start

Setup

  1. Open Settings from the sidebar
  2. Go to API Keys and add your Quackr.io API key
  3. Go to Phone Numbers and add numbers to monitor (or use Account > Import from Quackr to auto-import)
  4. Configure Notifications if you want Discord, Slack, or Telegram alerts
  5. Messages will start appearing automatically

Data Storage

All settings (API keys, phone numbers, notification config, poll intervals) are stored locally by electron-store at:

OS Path
Windows %APPDATA%\Quack Manager\config.json
macOS ~/Library/Application Support/Quack Manager/config.json
Linux ~/.config/Quack Manager/config.json

API keys are stored in plain text in this file. Do not share it.

Tech Stack

Project Structure

quack-manager/
├── assets/
│   ├── icon2.png            # App icon
│   └── screenshots/         # App screenshots
├── src/
│   ├── index.html           # App shell
│   ├── styles.css           # Dark/light theme styles
│   ├── renderer.js          # Dashboard UI logic
│   └── settings.js          # Settings panel logic
├── main.js                  # Electron main process, polling engine, notifications
├── preload.js               # Secure IPC bridge
└── package.json

License

MIT

About

Manage multiple Quackr.io virtual phone numbers and SMS messages

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors