Documentation

NotiHub Quickstart: A Step-by-Step Setup Tutorial

5 min read NotiHub Editorial

Welcome to the NotiHub ecosystem. This guide will walk you through the absolute fastest path to centralizing your first critical notification source, ensuring your background monitor is safely active, and fully testing the audio-visual feedback loop.

Phase 1: Generating an App Password

Because NotiHub values your security, we never ask for your primary email password. We utilize strict Application-Specific Passwords.

  • For Gmail: Navigate to your Google Account > Security > 2-Step Verification > App Passwords.
  • Generate: Create a new password labeled "NotiHub Desktop."
  • Copy: Copy the 16-character string. Do not include spaces.

Phase 2: Adding Your First Source

Navigate to the Sources wizard within your NotiHub dashboard.

1. Select Platform

Choose "Custom IMAP" or select a preset template like Gmail or Upwork.

2. Input Credentials

Enter your email address and paste the 16-character App Password generated in Phase 1.

Phase 3: Activating the Global Monitor

Adding a source saves it to your database, but you must instruct the engine to begin polling.

The Global Toggle

Locate the large "Monitoring Status" toggle card on your main Dashboard. Switching this to "ON" starts the background multi-threaded worker. The status badge will change from red to green.

Phase 4: Testing the Workflow

To ensure everything is working, send a test email to the account you just configured.

  • Ensure the email arrives in the INBOX and is marked as UNREAD.
  • Wait for the polling cycle (typically 30-60 seconds).
  • You should hear your selected Ringtone and see the new alert appear in your Dashboard Feed.

If you encounter issues during setup, ensure IMAP is explicitly enabled in your email provider's core settings.