OAuth Forwarder

The OAuth Forwarder module forwards emails from your Outlook accounts to a single inbox. Perfect for monitoring all your accounts in one place.

What You Need

Before you start, make sure you have:

• Outlook accounts with OAuth tokens + IMAP Activated from OAuth Adder + Checker

• An email account to send forwarded emails (Gmail works, custom mailserver without ratelimits is better tho)

Step 1: Enable IMAP on Your Accounts

First, you need to enable IMAP access on your Outlook accounts using the Checker, make sure you don't do this right after the generation wait at least 48 hours to run the checker:

1. Go to Outlook → Checker, select option to enable IMAP

2. Run it on your accounts

3. The checker will automatically enable IMAP for each account

Step 2: Generate OAuth Tokens

Now run OAuth Adder to get the tokens needed for forwarding:

1. Go to Outlook → OAuth Adder

2. Run it on your accounts

3. This creates oauth_OutlookAccounts.csv with your tokens

Step 3: Configure OAuth Forwarder

Open your settings.json file and find the OAuthForwarder section. EXAMPLE:

"OAuthForwarder": {
    "target_email": "[e-mail]",
    "smtp_server": "smtp.gmail.com",
    "smtp_port": 587,
    "smtp_username": "[e-mail]",
    "smtp_password": "abcd efgh ijkl mnop",
    "smtp_use_tls": true,
    "smtp_use_ssl": false,
    "since_days": 1,
    "delete_after_forward": false,
    "unread_only": false,
    "monitor_mode": false,
    "monitor_interval": 30
}

Setting	What to put
target_email	The email where you want ALL emails forwarded to
smtp_username	Your Gmail address (the one you created the app password for)
smtp_password	The 16-character app password from Step 3

Step 4: Run OAuth Forwarder

1. Start Skyridge

2. Go to Outlook → OAuth Forwarder

3. Enter number of threads (50-100 is fine)

All emails from your Outlook accounts will be forwarded to your target inbox.

Configuration Explained

Here's what each setting does:

Setting	What it does	Recommended
target_email	Where all emails get forwarded to	Your main inbox
smtp_server	The server that sends the emails	SMTP LOGIN
smtp_port	The port for the server	587
smtp_username	Your login for the SMTP server	SMTP LOGIN
smtp_password	Your app password	From Step 3
smtp_use_tls	Enables encryption	true
smtp_use_ssl	Alternative encryption	false
since_days	Only forward emails from last X days	1-7
delete_after_forward	Delete emails after forwarding	false
unread_only	Only forward unread emails	false
monitor_mode	Keep checking for new emails	true
monitor_interval	Seconds between checks	30

Monitor Mode (Live Forwarding)

Want emails forwarded automatically as they arrive? Enable monitor mode!

Change these settings in settings.json:

"monitor_mode": true,
"monitor_interval": 30

What happens:

• The module runs forever, checking every 30 seconds

• New emails are forwarded instantly

• Already-forwarded emails are marked as read (won't forward twice)

Using Proxies

Each account can use a different proxy for the IMAP connection. Add the proxy to your profx file you select. If you get 403 / Other proxy related errors make sure to use ISPs / DCs as they tend to perform much better.

Format:

ip:port:username:password

Example:

123.45.67.89:8080:proxyuser:proxypass

Common Problems

"SMTP authentication failed"

Cause: Wrong password or not using app password

Fix:

• Make sure you're using the Gmail App Password, not your regular password

• The app password has no spaces: abcdefghijklmnop

• Double-check your smtp_username is correct

"Token refresh failed"

Cause: Your OAuth tokens have expired

Fix:

• Run OAuth Adder again on your accounts

• This generates fresh tokens

"No emails found"

Cause: No emails match your filters

Fix:

• Increase since_days to check older emails (try 7 or 30)

• Set unread_only to false

• Make sure your accounts actually have emails

"Proxy error: 403 Forbidden"

Cause: Proxy doesn't support IMAP connections

Fix:

• Try a different proxy

• Check proxy credentials are correct