thomasgassmann / mycloud-cli

Swisscom myCloud CLI

Swisscom myCloud CLI

THIS PROJECT IS NO LONGER ACTIVELY MAINTAINED

Swisscom myCloud CLI is a command line utility to manage all your data stored on Swisscom myCloud. To achieve this, it uses the public Swisscom myCloud API.

Requirements

Any Keyring Backend comptatible with the keyring package is required in order to store the credentials for myCloud.

Usage

Docker

docker run -it mycloud-cli

Manual Installation

First, make sure chromium and chromedriver are installed and in your $PATH.

To install or upgrade myCloud CLI via pip, run:

python3 -m pip install --user --upgrade mycloud-cli

After installing myCloud CLI make sure to add the certificates for mitmproxy to your CA in your OS / Chromium. Run:

mycloud auth cert

to download the required certificate.

Authenticate

To use myCloud CLI, run mycloud [command]. Then authenticate yourself with your username and password using:

mycloud auth login

To get a list of all available commands, run:

mycloud -h

WebDAV

myCloud CLI includes a basic WebDAV Proxy out of the box.

To run it, first configure the credentials for the WebDAV server using:

mycloud config webdav

Then start the server using:

mycloud webdav --host ip --port port

Setup local environment

First, clone the repository:

git clone https://github.com/thomasgassmann/mycloud-cli

Then install all dependencies via pipenv:

cd mycloud-cli
export PIPENV_VENV_IN_PROJECT="enabled"
pipenv install --python 3.7
pipenv shell

Then run python -m mycloud auth cert to install the certificates as described in the Installation section.

mycloud-cli's Issues

Use asyncio for requests

The asyncio library should be used instead of threading when making requests to myCloud or doing other IO operations.

Check possibility to use LFS

Check possibility to use the LFS endpoint to upload bigger files.
Notes on API:

POST https://storage.prod.mdl.swisscom.ch/lfs
POST https://storage.prod.mdl.swisscom.ch/lfs/[id]/[partIndex]

Add CI/CD

Add continuous integration / continuous delivery

Linting

Add pylint and solve all linting errors.

Remove file conversion

Remove the file conversion module, since it is no longer needed.

Simplify settings

• Store all settings including constants in one file
• Make settings easily editable for user
• Use only one configuration file

Add support for ZIP download

Add support to download files / directories in a zipped format using the API provided at:
POST https://storage.prod.mdl.swisscom.ch/jobs/zip

Don't force user to use custom versioning

The user should not be forced to use the custom versioning style with the mycloud_metadata.json file. The module for handling these things should either be removed or made optional via a flag or a subcommand.

Add command for token

Add a command to print Bearer token, e.g. mycloud auth token.

Support trash

Support putting files into trash by using:
PUT https://storage.prod.mdl.swisscom.ch/trash/items

Google Photos Import

Add support for importing photos from Google Photos to myCloud

Add WebDAV proxy

Add a command to run the myCloud CLI in a WebDAV proxy mode. The myCloud CLI could for example start a daemon that would provide a WebDAV endpoint to other applications. The myCloud CLI would then "translate" all incoming WebDAV requests to myCloud.
This would also allow mounting your myCloud Drive via davfs2.

Add unit tests

Add unit tests for features in myCloud CLI and mock all corresponding endpoints.

Investigate moving files

Check the possibility to the move API to move files, instead of using the rename API:
https://storage.prod.mdl.swisscom.ch/commands/move

Add command to display sessions

Add a command to the myCloud CLI, which will allow displaying sessions via the following API:
GET https://identity.prod.mdl.swisscom.ch/sessions?nocache=time

Properly kill all threads on KeyboardInterrupt

Properly kill all background threads before exiting, when a KeyboardInterrupt occurs

Use logging module

Use default python logging module for all logs

Display account information

Display account information using the following API:
GET https://identity.prod.mdl.swisscom.ch/me

Allow for easier authentication

Instead of having to specify the username each time, allow the username to be written into a file and defaulted. Whenever running the myCloud CLI, prompt the user to enter his/her password without displaying it.

Remove token config file

Remove the token config file, since it stores the myCloud token and any other program could potentially access it.