Skyridge Inbox Tool

When you first open Skyridge Inbox, you'll see a license screen. Enter your
license key to authenticate and access the application. Your session persists
across restarts until you logout. 

Place the Inbox Tool wherever you want it doesn't need any file structure

Adding Your First Accounts

Before bulk importing accounts, we recommend adding one account of each provider
type manually. This helps you understand the required fields and get a proper
CSV export template.

Step 1: Add a Gmail Account
1. Click the "+" button in the left sidebar or go to Accounts view and click
   "Add Account"
2. Enter your Gmail address (e.g., [e-mail])
3. The app auto-detects Gmail and sets the server to imap.gmail.com:993
4. Select Login Type: "Password" or "OAuth2"
   - For Password: Use an App Password (generate at myaccount.google.com >
     Security > App Passwords)
   - For OAuth2: Enter your Refresh Token and Client ID
5. Leave Folders as "INBOX" or add more like "INBOX, Sent"
6. Optional: Add a proxy (recommended for multiple accounts)
7. Click "Add Account"

Step 2: Add an Outlook Account
1. Click "Add Account"
2. Enter your Outlook address (e.g., [e-mail])
3. The app auto-detects Outlook and sets server to outlook.office365.com:993
4. Login Type will default to OAuth2 for Outlook
5. Enter your Refresh Token and Client ID
6. Folders default to "INBOX, JUNK"
7. Click "Add Account"

Step 3: Test Your Accounts
1. Go to the Accounts view (click the accounts icon in the top navigation)
2. Find your account cards
3. Click "Test" on each to verify the connection works
4. You should see "Connected (XXms)" if successful

Bulk Importing Accounts via CSV

Getting the CSV Format:
1. After adding your test accounts, go to Accounts view
2. Click "Export CSV"
3. Save the file (e.g., accounts.csv)
4. Open the CSV in a spreadsheet program or text editor

CSV Column Format:
email,password,provider,login_type,imap_host,imap_port,imap_ssl,mail_proxy,folders,refresh_token,access_token,client_id

Column Descriptions:
- email         - The email address (required)
- password      - Account password (for password login type)
- provider      - gmail, outlook, yahoo, aol, zoho, or custom
- login_type    - password or oauth2
- imap_host     - IMAP server (e.g., imap.gmail.com)
- imap_port     - Usually 993
- imap_ssl      - true or false
- mail_proxy    - Optional proxy (IP:PORT:USER:PASS or socks5://host:port)
- folders       - Comma-separated folders to sync (e.g., INBOX or INBOX,Sent)
- refresh_token - OAuth2 refresh token (for oauth2 login type)
- access_token  - OAuth2 access token (optional, usually auto-refreshed)
- client_id     - OAuth2 client ID

Filling Out the CSV:
1. Copy rows from your exported accounts as templates
2. Change the email, password/tokens for each new account
3. Keep the same provider settings if adding more of the same type
4. Save the file

Importing:
1. Go to Accounts view
2. Click "Import CSV"
3. Select your filled CSV file
4. The app shows import results (successes and failures)

Tips for Bulk Import:
- Test one account of each type manually first
- Use the same proxy format consistently
- For OAuth2 accounts, you need valid refresh tokens for each account
- Leave optional fields empty

Editing an Account
1. Go to Accounts view
2. Find the account card
3. Click "Edit"
4. Modify settings and click "Save Changes"

Removing an Account
Method 1: In Accounts view, click "Remove" on the account card
Method 2: In the main view, right-click an account in the left sidebar and
          select "Remove Account"

Note: Removing an account deletes all locally synced messages for that account.

Delete All Accounts
In Accounts view, click "Delete All" to remove all accounts at once.
Use with caution.

Folders let you group accounts visually, like Discord server folders.

Creating a Folder
1. In the main view, click the folder icon in the Accounts panel header
2. The Folder Manager opens
3. At the bottom, click the color square to choose a color
4. Type a folder name
5. Click "Add" or press Enter

Assigning Accounts to Folders

Individual Assignment:
1. In the main view, right-click an account in the left sidebar
2. Hover over the folder names in the menu
3. Click a folder to assign (checkmark shows current assignment)
4. Click again to remove from folder

Bulk Assignment:
1. Open Folder Manager (folder icon)
2. Click "Bulk Assign Accounts"
3. Search or scroll to find accounts
4. Check the accounts you want to assign
5. Use "Select All" to select all visible accounts
6. Choose a target folder from the dropdown (or "Remove from folder")
7. Click "Apply"

Assigning Accounts to Folders

Individual Assignment:
1. In the main view, right-click an account in the left sidebar
2. Hover over the folder names in the menu
3. Click a folder to assign (checkmark shows current assignment)
4. Click again to remove from folder

Bulk Assignment:
1. Open Folder Manager (folder icon)
2. Click "Bulk Assign Accounts"
3. Search or scroll to find accounts
4. Check the accounts you want to assign
5. Use "Select All" to select all visible accounts
6. Choose a target folder from the dropdown (or "Remove from folder")
7. Click "Apply"

Editing a Folder
1. Open Folder Manager
2. Hover over a folder and click the pencil icon
3. Change name or color
4. Click the checkmark to save

Deleting a Folder
1. Open Folder Manager
2. Hover over a folder and click the trash icon
3. The folder is removed; accounts become ungrouped

Selecting Which Emails to View
- Click "All Inboxes" to see emails from all accounts combined
- Click a specific account to see only its emails
- Click a folder name to expand it, then select an account within

Syncing Emails

Manual Sync:
- Click the "Sync" button in the toolbar to sync all accounts
- Or right-click a specific account and select "Sync"

Auto-Sync:
1. Click the play button next to the Sync button
2. A countdown shows time until next sync
3. Change the delay (in seconds) using the input field
4. Click pause to stop auto-sync

Reading Emails
- Click any email row to open and read it
- Unread emails appear bold with a blue dot
- Opening an email marks it as read automatically
- Click the back arrow to return to the list

Filtering Emails
Use the filter buttons in the toolbar:
- All     - Show all emails
- Unread  - Show only unread emails
- Read    - Show only read emails

Searching Emails
1. Type in the search box (top right)
2. Search matches sender and subject
3. Results filter as you type
4. Click X to clear the search

Selecting Multiple Emails
1. Click checkboxes on email rows
2. A selection bar appears showing count
3. Use the selection bar buttons:
   - Mark as Read
   - Mark as Unread
   - Delete

Email Context Menu (Right-Click)
Right-click any email for options:
- Mark as Read / Mark as Unread
- Open
- Copy Subject
- Copy Sender
- Delete

INBOX API FEATURES

The Inbox API lets you sync accounts to a remote server for cloud access and
third-party tool integration.

Checking API Connection
1. Click the API icon in the top navigation
2. The header shows connection status (Connected/Disconnected)
3. Click "Refresh" to recheck

Viewing API Accounts
1. Go to API view
2. The "Accounts" tab shows all accounts synced to the API
3. Each account displays:
   - Email and provider
   - Status (active/paused)
   - Folder and message counts
   - Last sync time
4. Click "Sync" to trigger immediate sync for an account
5. Click "Remove" to remove an account from the API

Pushing Local Accounts to the API

Steps:
1. Go to API view
2. Click the "Push to API" tab
3. You'll see all your local accounts
4. Accounts already on API show "On API" and are disabled
5. Check the accounts you want to push
6. Click "Push (X)" where X is the selected count
7. Wait for the push to complete
8. Results show success/failure for each account

Requirements:
- API must be connected
- Accounts can only be pushed once (no duplicates)

Managing Your API Key

API keys allow third-party tools to search your synced emails.

Generating a Key:
1. Go to API view
2. Click the "API Key" tab
3. If no key exists, click "Generate API Key"
4. Your key is created and displayed

Viewing and Copying Your Key:
1. The key is partially hidden for security
2. Click "Copy" to copy the full key to clipboard
3. The button shows a checkmark when copied

Regenerating Your Key:
1. Click "Reroll" to generate a new key
2. Warning: The old key becomes invalid immediately
3. Update any third-party tools with the new key

Key Information:
- Shows when the key was created
- Shows when it was last used

TROUBLESHOOTING
--------------------------------------------------------------------------------

Account won't connect:
- Click "Test" to see the specific error
- Verify your password or OAuth2 tokens are correct
- Check that IMAP is enabled in your email provider settings
- For Gmail, you may need an App Password

Emails not syncing:
- Check the account status icon in the sidebar
- Click Sync manually
- Verify the folders field includes the right folder names

API not connecting:
- Click Refresh in the API view
- Check your internet connection
- Verify the API server is available

Import failed:
- Check CSV format matches the export format exactly
- Ensure no extra columns or formatting
- Verify all required fields are filled

RECOMMENDED WORKFLOW FOR NEW USERS
--------------------------------------------------------------------------------

1.  Add test accounts manually - Add one Gmail and one Outlook account to
    learn the interface
2.  Test connections - Use the Test button to verify accounts work
3.  Export CSV - Get the proper format template
4.  Fill CSV - Add your additional accounts following the template
5.  Import CSV - Bulk import all accounts
6.  Create folders - Organize accounts into logical groups
7.  Bulk assign - Use bulk assign to quickly organize many accounts
8.  Set up auto-sync - Enable auto-sync with your preferred interval
9.  Push to API - If using remote access, push accounts to the API
10. Generate API key - Create a key for third-party tool access