abraunegg/onedrive
Onedrive
This project is a command-line synchronization client for OneDrive and SharePoint libraries on Linux. It functions as a synchronization engine that aligns local filesystems with cloud storage through bidirectional, unidirectional, or download-only workflows.
The client supports headless authentication for servers without web browsers and can be deployed as a background service or within a containerized environment. It enables the management of multiple distinct cloud accounts on a single system and integrates with shared SharePoint sites and document libraries.
The synchronization engine includes real-time change detection, multi-threaded transfers with resumable byte-range support, and pattern-based content filtering. To prevent data loss, the system implements mass deletion protection, mount point verification, and conflict resolution via local backups.
The tool provides command-line utilities for configuration validation, runtime inspection, and the generation of shareable links for remote files.
Features
- OneDrive Cloud Synchronization - Synchronizes files and folders between a Linux local filesystem and OneDrive cloud storage.
- Synchronization Clients - Implements a full synchronization client to keep local Linux files and OneDrive cloud storage consistent.
- Cloud Storage Sync Tools - Provides a command-line utility to synchronize local filesystems with OneDrive and SharePoint cloud storage.
- Multi-Account Management - Allows the simultaneous management of multiple distinct OneDrive or SharePoint accounts using separate configurations.
- SharePoint Connectors - Integrates with Microsoft SharePoint to identify and synchronize specific file libraries and document sites.
- Cloud Storage Clients - Provides a command-line client for managing remote files and cloud storage operations.
- Local State Caches - Maintains a local database of remote metadata and file hashes to track unsynchronized changes and validate integrity.
- Bidirectional File Synchronization - Automatically aligns local and remote data by uploading local changes and downloading remote updates.
- Bidirectional Cloud Directory Synchronizers - Functions as a synchronization engine that aligns local and remote file states using bidirectional transfers.
- Real-Time Synchronization - Uses filesystem hooks and remote sockets to trigger synchronization immediately upon detecting data changes.
- Headless Cloud Synchronization - Supports cloud storage synchronization on remote servers without a web browser via device authorization.
- Multi-threaded File Delivery - Uses a multi-threaded transfer engine with a configurable worker pool to maximize network throughput for uploads and downloads.
- Microsoft Account Integrations - Provides authentication and authorization flows for personal, work, and school Microsoft accounts.
- OAuth Token Management - Manages secure cloud access using OAuth browser flows and the lifecycle of authorization tokens stored locally.
- File State Reconciliation - Compares local and remote metadata to determine required transfers and resolve conflicts between disparate versions.
- Filesystem Change Monitors - Implements real-time change detection using filesystem hooks and remote sockets to trigger immediate synchronization.
- Shared Folder Synchronization - Synchronizes shared folders that have been added as shortcuts to the primary file list.
- Accidental Data Loss Protections - Protects against accidental data loss by blocking synchronization when a large number of files are deleted simultaneously.
- Local Filesystem Authoritative Mirroring - Implements a mirroring mode where the local filesystem is the authoritative source for remote cloud storage.
- Unidirectional Sync Configurations - Enables unidirectional synchronization for upload-only or download-only workflows.
- Directional Sync Modes - Supports configurable synchronization modes including upload-only, download-only, and bidirectional data flows.
- Mounted Drive Availability Detection - Prevents remote deletions by detecting when a mounted filesystem becomes unavailable before starting a sync cycle.
- Mount Point Protection - Prevents synchronization on unmounted drives by detecting the absence of specific indicator files at the mount point.
- Mount Point Safety Protections - Aborts synchronization if marker files are missing at mount points to prevent writing to the wrong filesystem.
- Shared Library Identification - Identifies and synchronizes shared folders and libraries from cloud environments to the local system.
- Sync Deletion Management - Manages whether local deletions are mirrored to the cloud, sent to a recycle bin, or deleted permanently.
- Sync Content Filtering - Uses wildcard inclusion and exclusion rules to filter specific files or directories from the synchronization process.
- Cloud Backups - Facilitates a cloud backup workflow using unidirectional synchronization to upload local files.
- Bandwidth Management - Optimizes transfer speeds with multi-threading and manages network impact via bandwidth rate limiting.
- Download Resumption - Resumes interrupted uploads or downloads of large files using byte-range requests.
- Shared File Synchronization - Downloads individual files shared by other users and organizes them locally by sender.
- Resource Update Subscriptions - Uses sockets or webhooks to receive near-real-time notifications of changes on the remote server.
- Cloud File Downloads - Supports a download-only mode to copy files from the cloud to the local system without modifying the remote source.
- Resumable File Transfers - Tracks successful byte-offsets to resume interrupted large file transfers for both uploads and downloads.
- Device Authentication Flows - Supports sign-in via device authorization flows for systems without a web browser.
- Synchronization Exclusions - Excludes specific files or directories from the synchronization process using wildcard rules and inclusion lists.
- Sync Conflict Resolution - Prevents data loss by creating local backups when conflicting changes are detected between local and remote versions.
- Background Synchronization Services - Configures background services via systemd to ensure automatic synchronization on system startup.
- CLI Applications - Free OneDrive client for Linux.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
