https://github.com/lexoyo/cloud-disk-usage
Summarize cloud storage usage of each FILE, recursively for directories from local file system, Dropbox, Github, FTP, SFTP, Webdav, NextCloud, OwnCloud.
https://github.com/lexoyo/cloud-disk-usage
Last synced: 7 months ago
JSON representation
Summarize cloud storage usage of each FILE, recursively for directories from local file system, Dropbox, Github, FTP, SFTP, Webdav, NextCloud, OwnCloud.
- Host: GitHub
- URL: https://github.com/lexoyo/cloud-disk-usage
- Owner: lexoyo
- Created: 2017-09-29T07:00:16.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-03-04T03:57:30.000Z (over 2 years ago)
- Last Synced: 2025-03-19T03:56:46.738Z (7 months ago)
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/cloud-disk-usage
- Size: 71.3 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
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](http://www.linuxcommand.org/lc3_man_pages/du1.html).
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
* [x] recursively compute a folder size from all supported services
* [x] oauth to connect to github and dropbox
* [x] remember connection details to connect again
* [x] human readable format option
* [x] 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
```