Accounts for COSMIC™

A comprehensive online account management system for the COSMIC desktop environment

Components

accounts/ (Core Library)

• Account, Provider, and Credential models
• Service abstraction layer for different services
• D-Bus client proxy for communication

accounts-daemon/

• D-Bus service implementation (dev.edfloreshz.Accounts)
• OAuth2 authentication manager
• Secure credential storage
• Provider configuration management
• Integrated HTTP callback server

accounts-ui/

• COSMIC desktop application
• Account listing and management
• Provider selection and authentication flow
• Visual account status and controls

Architecture

Authentication System

• OAuth2 with PKCE for enhanced security
• Automatic token refresh to maintain valid credentials
• Built-in callback server for seamless auth flow
• CSRF protection for auth requests

Provider Support:

• Google - Gmail, Calendar, Contacts, Drive integration
• Microsoft - Outlook, Office 365, OneDrive support
• Extensible provider system for easy addition of new services

Service Integration

• Mail services (Gmail, Outlook)
• Calendar synchronization (Google Calendar, Outlook Calendar)

Contributing

Contributions are welcome! Please read our Contributing Guidelines and Code of Conduct.

Related Projects

• GNOME Online Accounts - Inspiration for this project
• libcosmic - COSMIC UI toolkit
• COSMIC Desktop - The COSMIC desktop environment

Support

• GitHub Issues
• COSMIC Discord
• System76 Community