Skip to main content

Settings Overview

Customize every aspect of Xermius—from appearance to security, terminal preferences to synchronization—all in one place.

Accessing Settings​

Multiple ways:

1. Menu Bar → Settings (Cmd+,)
2. Main View → Settings Tab
3. Keyboard: Cmd+, (Mac) or Ctrl+, (Windows/Linux)

Settings Categories​

Account​

Manage your profile and authentication:

Settings → Account

Configure:
- Profile information (name, email, avatar)
- Password & security
- Two-factor authentication
- Account deletion

Billing​

Subscription and payment management:

Settings → Billing

Manage:
- Current plan
- Payment methods
- Invoices
- Upgrade/downgrade

Terminal​

Customize terminal appearance:

Settings → Terminal

Adjust:
- Font family & size
- Color scheme
- Cursor style
- Bell sound
- Line height

Notifications​

Control notification behavior:

Settings → Notifications

Configure:
- In-app notifications
- Desktop notifications
- Sound alerts
- Do Not Disturb

Synchronization​

Cloud sync settings:

Settings → Synchronization

Set up:
- Cloud sync (on/off)
- Sync server
- Sync frequency
- Conflict resolution

Updates​

Auto-update preferences:

Settings → Updates

Control:
- Automatic updates
- Update channel (stable/beta)
- Check for updates
- Update history

Settings Interface​

┌──────────────────────────────────────────────┐
│ ⚙ Settings                                   │
│ Configure application preferences            │
├────────────┬─────────────────────────────────┤
│            │                                 │
│ 👤 Account  │  Account Settings              │
│ 💳 Billing  │                                 │
│ 🖥 Terminal │  Profile Information            │
│ 🔔 Notifications                             │
│ 🔄 Synchronization Name:                     │
│ ⬇ Updates  │  [John Doe              ]       │
│            │                                 │
│            │  Email:                         │
│            │  [john@example.com      ]       │
│            │                                 │
│            │  Avatar:                        │
│            │  [Choose File...]               │
│            │                                 │
│            │  [Save Changes]                 │
└────────────┴─────────────────────────────────┘

Quick Settings​

Theme Toggle​

Fast theme switching:

Bottom right corner → 🌙/☀️ icon
or
Settings → Terminal → Theme

Options:
- Light mode
- Dark mode
- System (auto)

Font Size Quick Adjust​

In terminal:

Zoom In:  Cmd/Ctrl + Plus
Zoom Out: Cmd/Ctrl + Minus
Reset:    Cmd/Ctrl + 0

Notifications Toggle​

Quick disable:

Notification Center → ⋯ → Disable Notifications

Common Settings​

Change Theme​

Settings → Terminal → Theme

● Light
○ Dark
○ System (follows macOS/Windows)

[Apply]

Change Font​

Settings → Terminal → Font

Font Family:
[Monaco              ▼]

Font Size:
[14] pt

Line Height:
[1.2]

[Preview: The quick brown fox...]

Enable Cloud Sync​

Settings → Synchronization

Cloud Synchronization:
[✓] Enable cloud sync

Sync Server:
[sync.xermius.com     ]

Sync Frequency:
● Every 5 minutes
○ Every 15 minutes
○ Every hour
○ Manual only

[Test Connection] [Save]

Configure Auto-Update​

Settings → Updates

Automatic Updates:
[✓] Automatically download updates
[✓] Install updates automatically

Update Channel:
● Stable (recommended)
○ Beta (early access)

Current Version: 2.1.0
Last Check: 2 hours ago

[Check for Updates Now]

Find settings quickly:

Settings → Search box at top
[Search settings...        🔍]

Examples:
"font"     → Font settings
"theme"    → Appearance
"sync"     → Synchronization
"security" → Security options

Import/Export Settings​

Export Settings​

Backup your configuration:

Settings → ⋯ (menu) → Export Settings

Choose what to export:
[✓] Terminal settings
[✓] Preferences
[✓] Notifications
[✓] Keyboard shortcuts
[ ] Saved passwords (not recommended)

[Export as JSON]

Save to: settings-backup-2024-01-17.json

Import Settings​

Restore configuration:

Settings → ⋯ (menu) → Import Settings

Select file:
[Choose File...] settings-backup-2024-01-17.json

Preview changes:
- Theme: Light → Dark
- Font: Monaco → Menlo
- Sync: Disabled → Enabled

[✓] Overwrite existing settings
[ ] Merge with current settings

[Import]

Reset Settings​

Reset to Defaults​

Start fresh:

Settings → ⋯ (menu) → Reset to Defaults

Warning:
⚠️ This will reset all settings to default values.
Your hosts and data will NOT be affected.

Choose what to reset:
[✓] Terminal settings
[✓] Appearance
[✓] Notifications
[ ] Account settings

[Cancel] [Reset Settings]

Reset Specific Category​

Settings → Terminal → Reset Terminal Settings
Settings → Notifications → Reset Notifications
etc.

Settings Sync​

Sync across devices:

Enable Sync:
Settings → Synchronization → Enable cloud sync

What syncs:
✓ Terminal settings (font, colors)
✓ Preferences (theme, auto-lock)
✓ Notification settings
✓ Keyboard shortcuts
✗ Hosts (separate sync)
✗ Passwords (security)

All devices will have same settings!

Keyboard Shortcuts​

Quick access:

Open Settings:        Cmd+,
Terminal Settings:    Cmd+Shift+T
Account:              Cmd+Shift+A
Close Settings:       Esc

Settings by Use Case​

For Beginners​

Essential settings:

1. Theme (Light/Dark)
   Settings → Terminal → Theme

2. Font Size
   Settings → Terminal → Font Size

3. Notifications
   Settings → Notifications → Enable

Done! Start using Xermius

For Power Users​

Advanced setup:

1. Custom font & colors
   Settings → Terminal

2. Cloud sync
   Settings → Synchronization

3. Auto-updates
   Settings → Updates

4. Two-factor auth
   Settings → Account → Security

5. Keyboard shortcuts
   Settings → Advanced → Shortcuts

For Teams​

Shared configuration:

1. Export settings
   Settings → Export

2. Share file with team
   settings-team-standard.json

3. Team imports
   Settings → Import

4. Everyone has same setup!

Tips & Best Practices​

1. Backup Settings​

Before major changes:
1. Export current settings
2. Make changes
3. Test new settings
4. Keep backup just in case

2. Use System Theme​

Settings → Terminal → Theme → System

Benefits:
- Auto light during day
- Auto dark at night
- Matches OS
- Easy on eyes

3. Regular Updates​

Settings → Updates
[✓] Automatic updates

Stay current:
- Bug fixes
- New features
- Security patches

4. Test Sync First​

Before enabling sync:
1. Export settings backup
2. Enable sync
3. Test on second device
4. Verify syncing works
5. Then rely on it

5. Document Custom Settings​

If heavily customized:
1. Export settings
2. Save with notes
3. Document what changed
4. Easy restore later

Troubleshooting​

Settings Not Saving​

Check:

1. Permissions (can write to disk?)
2. Disk space available?
3. Settings file corrupted?

Fix:
Settings → Reset to Defaults
Then reconfigure

Sync Not Working​

Verify:

Settings → Synchronization
[Test Connection]

If fails:
- Check internet
- Verify server address
- Check account status

Can't Change Font​

If font not applying:

1. Check font installed on system
2. Restart Xermius
3. Try different font
4. Reset terminal settings

Next Steps​