Navigate to Settings → Servers in the top navigation bar. Click "Add Account" to begin the configuration process.

Enter the essential details for your email account:

• Account Name: A descriptive name for identification (e.g., "Work Email", "Personal Gmail")
• Email Address: Your complete email address
• Display Name: Name that appears in sent messages
• Reply-to Address: Optional alternative reply address

Configure the incoming and outgoing mail servers:

Many providers (Google, Microsoft, Yahoo) require app-specific passwords instead of your regular password:

• Visit the Google Cloud Console.
• Sign in with the Google account that manages your application.
• If you do not have a project yet, choose Create Project and give it a name.
• If a project already exists, select it from the project list.

The project selector sits in the top bar of the console:

The consent screen is what your users see when they authorize Cypht to read their mailbox. Navigate to APIs & Services > OAuth consent screen, then provide:

• The application type External or Internal, depending on your needs.
• The application name displayed to users.
• Support and administrative contact email addresses.
• Your authorized domains (for example yourdomain.com, or localhost for development).
• A privacy policy URL if you have one.

Save your changes and continue, then add the accounts allowed to use the application while it is in test mode:

1. In the same OAuth consent screen, open the Test users tab.
2. Select Add users.
3. Enter the email addresses allowed to use the application during testing.
4. Confirm to display the list of authorized test accounts.

The consent screen and its test users tab:

1. Return to APIs & Services and choose Credentials.
2. Select Create credentials > OAuth client ID.
3. Set the application type to Web application.
4. Name the client, for example "Cypht – Gmail Authentication".
5. Define the authorized redirect URIs, then click Create.

The application type (1), the client name (2) and the authorized redirect URI (3):

# Development
http://localhost/my_cypht/?page=home

# Production
https://yourdomain.com/?page=home

Once the client is created, Google displays the two values Cypht needs:

• Client ID (1) this becomes your GMAIL_CLIENT_ID.
• Client secret (2) this becomes your GMAIL_CLIENT_SECRET.

GMAIL_CLIENT_ID=<client-id>
GMAIL_CLIENT_SECRET=<client-secret>

Both values are shown right after the client is created:

Your configuration is now complete: users can add their Gmail account from Cypht and authorize it through Google.

1. Go to the Azure portal and sign in with the Outlook account associated with your app.
2. In the search bar at the top, type App registrations and select the matching service.
3. If you already have an application, select it from the list.
4. Otherwise click + New registration, name your application, set the supported account types and the redirect URIs if needed, then click Register.

The app registrations service in the Azure portal:

• Once the application is registered or selected, you land on its Overview page.
• The Application (client) ID is displayed there. Note it down: it becomes OUTLOOK_CLIENT_ID or OFFICE365_CLIENT_ID.

The client ID on the application overview page:

1. In the left menu of your application page, under Manage, select Certificates & secrets.
2. In the Client secrets section, click + New client secret.
3. Add a description and choose a validity period 1 or 2 years, for example.
4. Click Add.

The Certificates & secrets screen where the secret is created:

You now have both values: the client ID (1) from the overview page, and the client secret (2) you just created.

# Outlook.com
OUTLOOK_CLIENT_ID=<client-id>
OUTLOOK_CLIENT_SECRET=<client-secret>

# Office 365
OFFICE365_CLIENT_ID=<client-id>
OFFICE365_CLIENT_SECRET=<client-secret>

The client secret value, displayed once after creation:

Your configuration is now complete: users can add their Outlook or Office 365 account from Cypht and authorize it through Microsoft.

1. Click Settings → Accounts → Add Account
2. Select "RSS/Atom Feed" as account type
3. Enter the Feed URL (e.g., https://example.com/feed.xml)
4. Choose a Display Name for the feed
5. Set Update Frequency (hourly, daily, manual)
6. Click Test Connection to verify the feed
7. Save and the feed will appear in your folder list

• Folder Prefix: Specify IMAP folder prefix (INBOX., etc.) for server compatibility
• Connection Limits: Set maximum concurrent connections to prevent server overload
• Message Limits: Configure how many messages to sync per folder
• Signature Management: Create and manage email signatures per account
• Notification Settings: Configure desktop or email notifications for new messages