GitPedia

Libcloudstorage

Official libcloudstorage repository.

From lemourin·Updated April 20, 2026·View on GitHub·

A `C++` library providing access to files located in various cloud services licensed under `GNU LGPLv2.1`. It is focused on the basic operations on those services. The project is written primarily in C++, distributed under the Other license, first published in 2017. Key topics include: amazondrive, amazons3, box, cloud-providers, dropbox.

Latest release: 1.10
June 24, 2020View Changelog →

libcloudstorage

Build status
Build Status
Coverity Scan Build Status
Codacy Badge
Discord
License: LGPLv2.1

A C++ library providing access to files located in various cloud services
licensed under GNU LGPLv2.1. It is focused on the basic operations on those
services.

Supported cloud providers:

  • GoogleDrive
  • OneDrive
  • Dropbox
  • box.com
  • YandexDisk
  • WebDAV
  • mega.nz
  • AmazonS3
  • pCloud
  • hubiC
  • 4shared
  • Google Photos (partial)

Supported operations on files:

  • list directory
  • download file
  • upload file
  • get thumbnail
  • delete file
  • create directory
  • move file
  • rename file
  • fetch direct, preauthenticated url to file

Requirements:

Building:

The generic way to build and install it is:

  • mkdir build && cd build && cmake .. && make && sudo make install

Optional dependency notes:

  • libcryptopp:

    when not found, ICrypto interface needs to be implemented

  • libcurl

    when not found, IHttp interface needs to be implemented

  • libmicrohttpd

    when not found, IHttpServer interface needs to be implemented

  • boost-filesystem

    when found, LocalDrive provider representing local directory will be
    included

  • mega

    when not found, mega cloud provider will not be included

FUSE:

In bin/fuse there is implemented a user space file system using fuse
(https://github.com/libfuse/libfuse) library. It will be build when fuse is
found. The file system is implemented using libfuse's low level api; however
high level api implementation is also provided. The file system supports
moving, renaming, creating directories, reading and writing new files. Writing
over already present files in cloud provider is not supported. The file system
uses asynchronous I/O to its full potency. It doesn't cache files anywhere by
itself which implies no local storage overhead. Most cloud providers are fast
enough when it comes to watching videos; with mega.nz being the fastest and
Google Drive being the slowest.

Windows:

It is possible to run cloudstorage-fuse under Windows using Dokan
(https://github.com/dokan-dev/dokany).

Usage:

To add cloud providers to file system, first the cloud providers need to be
added. This can be done by calling:

cloudstorage-fuse --add=provider_label

After cloud providers are added, the file system can be mount using:

cloudstorage-fuse mountpoint

Cloud Browser:

In bin/cloudbrowser there is a program which provides easy graphics user
interface for all the features implemented in libcloudstorage. It will be
built when its dependencies are found.

Cloud Browser dependencies:

  • Qt5Core, Qt5Gui, Qt5Quick

  • kirigami (https://github.com/KDE/kirigami)

  • Qt5WebView

    when found, Cloud Browser will use it to present the authorization scheme

  • ffmpeg

    when found, Cloud Browser will generate fallback thumbnails if cloud provider
    doesn't provide any

  • mpv

    when found, Cloud Browser will use mpv-based media player

Screenshot:

<a href="https://imgur.com/a/bF4CIS1"> <img src="https://i.imgur.com/oZ6kYHN.png" width="640" /> </a>

Apps that use libcloudstorage:

TODO:

Implement following cloud providers:

  • Apple ICloud
  • Asus WebStorage
  • Baidu Cloud
  • CloudMe
  • FileDropper
  • Fileserve
  • Handy Backup
  • IBM Connections
  • Jumpshare
  • MagicVortex
  • MediaFire
  • Pogoplug
  • SpiderOak
  • SugarSync
  • Tencent Weiyun
  • TitanFile
  • Tresorit
  • XXL Box

Implement bindings to various languages, notably script languages:

  • Obj-C
  • python
  • ruby
  • JavaScript / node
  • Java

Integrate in various desktops

  • KIO slave
  • gvfs implementation

Implement chunked uploads.

Contributors

Showing top 7 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from lemourin/libcloudstorage via the GitHub API.Last fetched: 6/29/2026