# owncloud/android architecture

> Architecture diagram of the GitHub repository owncloud/android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/owncloud/android
- Repository: https://github.com/owncloud/android

## Overview

This is the ownCloud Android client for accessing, syncing, and sharing files with Classic and Infinite Scale servers. The principal workflow is account authentication, browsing remote files, and syncing or sharing them; Spaces, media galleries, and device security are substantial companion capabilities. The graph combines README-documented product behavior with relationships visible in the supplied source index and excerpts. Several UI-to-domain links are not shown in sampled source, so they are omitted rather than inferred.

Main entry points: [`owncloudApp/src/main/java/com/owncloud/android/datamodel/FileDataStorageManager.kt`](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/datamodel/FileDataStorageManager.kt) (File data access), [`owncloudComLibrary/src/main/java/com/owncloud/android/lib/common/OwnCloudClient.java`](https://github.com/owncloud/android/blob/master/owncloudComLibrary/src/main/java/com/owncloud/android/lib/common/OwnCloudClient.java) (HTTP client), [`owncloudApp/src/main/java/com/owncloud/android/services/OperationsService.java`](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/services/OperationsService.java) (Operation queue), [`owncloudApp/src/main/java/com/owncloud/android/MainApp.kt`](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/MainApp.kt) (App startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and Security"]
  node_app["App startup<br/>[MainApp.kt]"]
  node_login["Authentication<br/>[LoginActivity.kt]"]
  node_account_state["Account management<br/>[AccountUtils.java]"]
  node_security["App lock<br/>[PassCodeManager.kt]"]
end

subgraph group_files["Files and Transfers"]
  node_file_browser["File browsing"]
  node_file_details["File details"]
  node_file_data["File data access"]
  node_file_domain["File domain model<br/>[OCFile.kt]"]
  node_operations["Operation queue"]
  node_sync["File synchronization<br/>[SyncOperation.java]"]
  node_local_storage[("Local file storage")]
  node_transfers["Transfer tracking"]
end

subgraph group_collaboration["Sharing and Spaces"]
  node_sharing["File sharing"]
  node_spaces["Spaces"]
end

subgraph group_connectivity["Server Connectivity"]
  node_space_service["Spaces service<br/>[OCSpacesService.kt]"]
  node_file_service["File service API<br/>[FileService.kt]"]
  node_share_service["Share service API<br/>[ShareService.kt]"]
  node_http_client["HTTP client"]
end

subgraph group_experience["Media and Device Features"]
  node_media["Media playback<br/>[MediaService.java]"]
  node_gallery["Photo gallery"]
end

node_user(("Android user"))
node_server[("ownCloud server")]

node_user -->|"uses"| node_app
node_app -.->|"starts sign-in"| node_login
node_login -->|"manages account"| node_account_state
node_user -->|"browses files"| node_file_browser
node_file_browser -.->|"loads file data"| node_file_data
node_file_data -->|"uses file model"| node_file_domain
node_file_data -.->|"reads local files"| node_local_storage
node_user -->|"syncs files"| node_sync
node_operations -->|"uses storage manager"| node_file_data
node_operations -->|"runs operation"| node_sync
node_user -->|"shares files"| node_sharing
node_sharing -.->|"requests sharing"| node_share_service
node_user -->|"uses Spaces"| node_spaces
node_spaces -.->|"requests Spaces"| node_space_service
node_space_service -->|"executes operations"| node_http_client
node_file_service -->|"uses client"| node_http_client
node_share_service -->|"uses client"| node_http_client
node_http_client -.->|"sends requests"| node_server
node_user -->|"secures app"| node_security
node_user -->|"views photos"| node_gallery
node_user -.->|"plays media"| node_media

click node_app "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/MainApp.kt"
click node_login "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/authentication/LoginActivity.kt"
click node_account_state "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/authentication/AccountUtils.java"
click node_security "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/security/passcode/PassCodeManager.kt"
click node_file_browser "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/files/filelist/MainFileListViewModel.kt"
click node_file_details "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/files/details/FileDetailsViewModel.kt"
click node_file_data "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/datamodel/FileDataStorageManager.kt"
click node_file_domain "https://github.com/owncloud/android/blob/master/owncloudDomain/src/main/java/com/owncloud/android/domain/files/model/OCFile.kt"
click node_operations "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/services/OperationsService.java"
click node_sync "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/operations/common/SyncOperation.java"
click node_local_storage "https://github.com/owncloud/android/blob/master/owncloudData/src/main/java/com/owncloud/android/data/providers/LocalStorageProvider.kt"
click node_sharing "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/sharing/OcsShareViewModel.kt"
click node_spaces "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/spaces/SpacesListViewModel.kt"
click node_space_service "https://github.com/owncloud/android/blob/master/owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/spaces/services/OCSpacesService.kt"
click node_file_service "https://github.com/owncloud/android/blob/master/owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/files/services/FileService.kt"
click node_share_service "https://github.com/owncloud/android/blob/master/owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/shares/services/ShareService.kt"
click node_http_client "https://github.com/owncloud/android/blob/master/owncloudComLibrary/src/main/java/com/owncloud/android/lib/common/OwnCloudClient.java"
click node_media "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/media/MediaService.java"
click node_gallery "https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/files/filelist/MainFileListFragment.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_login,node_account_state,node_security,node_user toneBlue
class node_file_browser,node_file_details,node_file_data,node_file_domain,node_operations,node_sync,node_local_storage,node_transfers,node_server toneAmber
class node_sharing,node_spaces toneMint
class node_space_service,node_file_service,node_share_service,node_http_client toneRose
class node_media,node_gallery toneIndigo
```

## Components

### Accounts and Security

- [App startup](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/MainApp.kt): `owncloudApp/src/main/java/com/owncloud/android/MainApp.kt`
- [Authentication](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/authentication/LoginActivity.kt): `owncloudApp/src/main/java/com/owncloud/android/presentation/authentication/LoginActivity.kt`
- [Account management](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/authentication/AccountUtils.java): `owncloudApp/src/main/java/com/owncloud/android/presentation/authentication/AccountUtils.java`
- [App lock](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/security/passcode/PassCodeManager.kt): `owncloudApp/src/main/java/com/owncloud/android/presentation/security/passcode/PassCodeManager.kt`

### Files and Transfers

- [File browsing](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/files/filelist/MainFileListViewModel.kt): `owncloudApp/src/main/java/com/owncloud/android/presentation/files/filelist/MainFileListViewModel.kt`
- [File details](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/files/details/FileDetailsViewModel.kt): `owncloudApp/src/main/java/com/owncloud/android/presentation/files/details/FileDetailsViewModel.kt`
- [File data access](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/datamodel/FileDataStorageManager.kt): `owncloudApp/src/main/java/com/owncloud/android/datamodel/FileDataStorageManager.kt`
- [File domain model](https://github.com/owncloud/android/blob/master/owncloudDomain/src/main/java/com/owncloud/android/domain/files/model/OCFile.kt): `owncloudDomain/src/main/java/com/owncloud/android/domain/files/model/OCFile.kt`
- [Operation queue](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/services/OperationsService.java): `owncloudApp/src/main/java/com/owncloud/android/services/OperationsService.java`
- [File synchronization](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/operations/common/SyncOperation.java): `owncloudApp/src/main/java/com/owncloud/android/operations/common/SyncOperation.java`
- [Local file storage](https://github.com/owncloud/android/blob/master/owncloudData/src/main/java/com/owncloud/android/data/providers/LocalStorageProvider.kt): `owncloudData/src/main/java/com/owncloud/android/data/providers/LocalStorageProvider.kt`
- **Transfer tracking**

### Sharing and Spaces

- [File sharing](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/sharing/OcsShareViewModel.kt): `owncloudApp/src/main/java/com/owncloud/android/presentation/sharing/OcsShareViewModel.kt`
- [Spaces](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/spaces/SpacesListViewModel.kt): `owncloudApp/src/main/java/com/owncloud/android/presentation/spaces/SpacesListViewModel.kt`

### Server Connectivity

- [Spaces service](https://github.com/owncloud/android/blob/master/owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/spaces/services/OCSpacesService.kt): `owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/spaces/services/OCSpacesService.kt`
- [File service API](https://github.com/owncloud/android/blob/master/owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/files/services/FileService.kt): `owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/files/services/FileService.kt`
- [Share service API](https://github.com/owncloud/android/blob/master/owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/shares/services/ShareService.kt): `owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/shares/services/ShareService.kt`
- [HTTP client](https://github.com/owncloud/android/blob/master/owncloudComLibrary/src/main/java/com/owncloud/android/lib/common/OwnCloudClient.java): `owncloudComLibrary/src/main/java/com/owncloud/android/lib/common/OwnCloudClient.java`

### Media and Device Features

- [Media playback](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/media/MediaService.java): `owncloudApp/src/main/java/com/owncloud/android/media/MediaService.java`
- [Photo gallery](https://github.com/owncloud/android/blob/master/owncloudApp/src/main/java/com/owncloud/android/presentation/files/filelist/MainFileListFragment.kt): `owncloudApp/src/main/java/com/owncloud/android/presentation/files/filelist/MainFileListFragment.kt`

### Other components

- **Android user**
- **ownCloud server**

## Connections

- Android user → App startup: uses (evidence: `README.md`)
- App startup → Authentication: starts sign-in
- Authentication → Account management: manages account (evidence: `owncloudApp/src/main/java/com/owncloud/android/presentation/authentication/AccountUtils.java`)
- Android user → File browsing: browses files (evidence: `README.md`)
- File browsing → File data access: loads file data
- File data access → File domain model: uses file model (evidence: `owncloudApp/src/main/java/com/owncloud/android/datamodel/FileDataStorageManager.kt`)
- File data access → Local file storage: reads local files
- Android user → File synchronization: syncs files (evidence: `README.md`)
- Operation queue → File data access: uses storage manager (evidence: `owncloudApp/src/main/java/com/owncloud/android/services/OperationsService.java`)
- Operation queue → File synchronization: runs operation (evidence: `owncloudApp/src/main/java/com/owncloud/android/services/OperationsService.java`)
- Android user → File sharing: shares files (evidence: `README.md`)
- File sharing → Share service API: requests sharing
- Android user → Spaces: uses Spaces (evidence: `README.md`)
- Spaces → Spaces service: requests Spaces
- Spaces service → HTTP client: executes operations (evidence: `owncloudComLibrary/src/main/java/com/owncloud/android/lib/resources/spaces/services/OCSpacesService.kt`)
- File service API → HTTP client: uses client
- Share service API → HTTP client: uses client
- HTTP client → ownCloud server: sends requests
- Android user → App lock: secures app (evidence: `README.md`)
- Android user → Photo gallery: views photos (evidence: `README.md`)
- Android user → Media playback: plays media
