cloud-disk-usage

Command line utility which displays the size of folders (recursively) and files in your cloud storage (e.g. Dropbox and more).


Keywords
du, linux, cli, optimize, disk space, hdd, space, disk, cloud, Dropbox, fs, FTP, SFTP, Github, NextCloud, Owncloud, webdav
License
GPL-3.0
Install
npm install cloud-disk-usage@1.0.12

Documentation

Command line utility which displays the size of folders (recursively) and files in your cloud storage (e.g. Dropbox and more). Inspired by the du (disk usage) command.

Supports Dropbox, Github, FTP, SFTP, Webdav, NextCloud, OwnCloud with oauth when available.

This is an efficient way to explore your online storage to know where the space is being wasted, giving you an idea of where to start cleaning.

Roadmap

  • recursively compute a folder size from all supported services
  • oauth to connect to github and dropbox
  • remember connection details to connect again
  • human readable format option
  • option to list files along with folders
  • sort option

Synopsis

cdu SERVICE FILE [OPTION]...

Possible values of the service option (case insensitive):

description Service
Dropbox Dropbox
local file system fs
FTP FTP
SFTP SFTP
Github Github
NextCloud/Owncloud (with webdav) webdav

Available options

  • -a, --all: write counts for all files, not just directories
  • -h, --human-readable: print sizes in human readable format (e.g., 1K 234M 2G)

Examples

Install the npm package

$ npm install -g cloud-disk-usage

Scan the local Documents folder

$ cdu fs ~/Videos
9568    /home/lexoyo/Videos/Webcam
116751  /home/lexoyo/Videos/peek
1852703 /home/lexoyo/Videos

With options

$ cdu fs ~/Videos -ah
9.6 M   /home/lexoyo/Videos/Webcam/2018-07-24-185812.webm
9.6 M   /home/lexoyo/Videos/Webcam
7.6 M   /home/lexoyo/Videos/peek/output.gif
7.6 M /home/lexoyo/Videos/peek
250.5 M   /home/lexoyo/Videos/hover.gif
750.5 M   /home/lexoyo/Videos/merge.gif
7.1 k /home/lexoyo/Videos/scrollbars.gif
1.0 G   /home/lexoyo/Videos

Scan remote folders:

$ cdu dropbox Photos
$ cdu ftp www
$ cdu github repo1/master/

for example the command cdu dropbox Photos will output something like this

2075407 Photos/Sample Album
2075407 Photos

Development

Install

$ npm i

test

Scan the local Documents folder

$ node ./lib/ fs ~/Documents