Scramble CLI

Official command-line client for Scramble Cloud — end-to-end encrypted file storage.

Upload, download, and manage your encrypted files directly from the terminal. All data is encrypted client-side before it leaves your machine.

Installation

npm install -g @scramble-cloud/cli

After installation the scramble-cli command is available system-wide.

Quick Start

# Log in to your Scramble Cloud account
scramble-cli login -u [email protected]

# List your files
scramble-cli ls

# Upload a file
scramble-cli upload ./document.pdf

# Download a file
scramble-cli download document.pdf -o ./downloaded.pdf

Authentication

Login

scramble-cli login -u <username>

The password is prompted interactively and never passed as a command-line argument.

| Option | Description | Default | |---|---|---| | -u, --username | Username or email (required) | — | | -k, --insecure | Allow self-signed SSL certificates | false |

If your account has 2FA enabled, you will be prompted for the code automatically after entering your password.

Logout

scramble-cli logout

Session Status

scramble-cli status

Commands

Navigation

| Command | Description | Example | |---|---|---| | pwd | Print current working directory | scramble-cli pwd | | cd <path> | Change directory | scramble-cli cd Documents | | ls [path] | List folder contents | scramble-cli ls /Photos |

cd supports relative paths (., ..) and absolute paths (/Photos/Vacation).

File Operations

Upload

scramble-cli upload ./photo.jpg
scramble-cli upload /home/user/report.pdf

Uploads a local file to the current remote directory.

Download

scramble-cli download photo.jpg
scramble-cli download photo.jpg -o ./local-copy.jpg

| Option | Description | |---|---| | -o, --output <path> | Output file path (defaults to original name in current local directory) |

Copy

# Copy with new name
scramble-cli cp file.txt copy.txt

# Copy into subfolder
scramble-cli cp file.txt /Backup/

# Copy with new name into subfolder
scramble-cli cp file.txt /Backup/renamed.txt

# Copy multiple files into a folder
scramble-cli cp file1.txt file2.txt /Backup/

# Copy a folder (requires -r)
scramble-cli cp -r MyFolder MyFolder_Backup

Move / Rename

# Rename a file
scramble-cli mv old-name.txt new-name.txt

# Move into subfolder
scramble-cli mv file.txt /Archive/

# Move multiple files
scramble-cli mv file1.txt file2.txt /Archive/

# Move a folder (requires -r)
scramble-cli mv -r MyFolder /Archive/

Delete

# Delete a file
scramble-cli rm document.pdf

# Delete multiple files
scramble-cli rm file1.txt file2.txt

# Delete a folder (requires -r)
scramble-cli rm -r OldFolder

# Delete multiple folders
scramble-cli rm -r folder1 folder2

Create Folder

scramble-cli mkdir NewFolder
scramble-cli mkdir /Documents/Work/Projects

Account Info

scramble-cli info

Shows storage usage (used / available / total) and account details.

WebDAV Server

Start a local WebDAV server to mount your Scramble Drive as a network drive or use it with any WebDAV-compatible client.

scramble-cli webdav

| Option | Description | Default | |---|---|---| | -p, --port <port> | Port number | 1900 | | --host <host> | Hostname to bind to | 127.0.0.1 | | -u, --username <user> | WebDAV username | admin | | --https | Enable HTTPS with self-signed certificate | false | | --no-cache | Disable smart cache | — | | --auth-mode <mode> | basic or digest | basic |

WebDAV Password

The WebDAV password can be provided in three ways (checked in this order):

1. Environment variable (best for automation / systemd):

SCRAMBLE_WEBDAV_PASSWORD=mypassword scramble-cli webdav

2. Stored password (best for desktop autostart):

scramble-cli webdav-password set    # set and store password
scramble-cli webdav-password clear  # remove stored password

3. Interactive prompt (default when no password is configured)

Autostart with systemd (Linux)

Create ~/.config/systemd/user/scramble-webdav.service:

[Unit]
Description=Scramble WebDAV Server
After=network-online.target

[Service]
ExecStart=/usr/bin/scramble-cli webdav
Restart=on-failure
RestartSec=5
EnvironmentFile=%h/.config/scramble-webdav.env

[Install]
WantedBy=default.target

Create ~/.config/scramble-webdav.env:

SCRAMBLE_WEBDAV_PASSWORD=your_webdav_password

Then enable and start:

chmod 600 ~/.config/scramble-webdav.env
systemctl --user enable scramble-webdav
systemctl --user start scramble-webdav

Example: Mount with rclone

# Start the WebDAV server
scramble-cli webdav

# In another terminal, mount with rclone

Follow the documentation here.

Requirements

• Node.js 18 or later
• A valid Scramble Cloud account

License

Proprietary — see LICENSE for details.

Copyright (c) 2026 Scramble Cloud UG (haftungsbeschraenkt)