NAME
megatools df - Show total available, used, or free space in the cloud
SYNOPSIS
megatools df [--free|--total|--used] [--mb|--gb|-h]
DESCRIPTION
Shows available, used and free space in the cloud in machine or human readable formats.
OPTIONS
- --total
-
Show only total available space (free + used).
- --free
-
Show only free space.
- --used
-
Show only used space.
- --human , -h
-
Display file sizes in a human readable format.
- --mb
-
Show in MiB units.
- --gb
-
Show in GiB units.
- -u <email> , --username <email>
-
Account username (email)
- -p <password> , --password <password>
-
Account password
- --no-ask-password
-
Never ask interactively for a password
- --reload
-
Reload filesystem cache
- --limit-speed <speed>
-
Set maximum allowed upload and download speed in KiB/s. This option overrides config file settings. 0 means no limit. When using ParallelTransfers > 1, upload speed limit is applied to each transfer individually.
- --proxy <proxy>
-
Use proxy server to connect to mega.nz. This option overrides config file settings. More information can be found in libcurl documentation at ⟨https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html⟩. Some acceptable values are:
- •
-
FCnoneF[0] : Disable proxy if it was enabled in the config file.
- •
-
FCsocks5://localhost:9050F[0] : Local SOCKSv5 proxy server
- •
-
FCsocks5h://localhost:9050F[0] : Local SOCKSv5 proxy server with DNS handled by the proxy
- --netif <ifname|ip>
-
Network interface or local IP address used for outgoing connections. You have to specify IP address bound to some of your local network interfaces, when specifying an IP address.
- --ip-proto <proto>
-
Which IP protocol to prefer when connecting to mega.nz (v4, v6, or any). This is just an advisory option. Megatools will resolve mega.nz domain, and then use an A or AAAA record based on the stated preference.
- --config <path>
-
Load configuration from a file
- --ignore-config-file
-
Disable loading .megarc
- --debug [<options>]
-
Enable debugging of various aspects of the megatools operation. You may enable multiple debugging options separated by commas. (eg. FC--debug api,fsF[0])
Available options are:
- •
-
FChttpF[0]: Dump HTTP request/response details (can be used to debug connection/proxy issues)
- •
-
FCapiF[0]: Dump Mega.nz API calls
- •
-
FCfsF[0]: Dump Mega.nz filesystem (may require FC--reloadF[0] to actually print something)
- •
-
FCcacheF[0]: Dump cache contents
- •
-
FCtmanF[0]: Dump transfer manager events
- --version
-
Show version information
EXAMPLES
- •
-
Show overall human readable space usage information:
FC$ megatools df -h Total: 50.0 GiB Used: 6.4 GiB Free: 43.6 GiBF[0]
- •
-
Check free space from a script:
FC$ test `megatools df --free --gb` -lt 1 && \ echo "You have less than 1 GiB of available free space"F[0]
KNOWN BUGS
Megadf can’t determine available space for premium accounts.
SEE ALSO
megatools(1), megarc(5), megatools-df(1), megatools-dl(1), megatools-get(1), megatools-ls(1), megatools-mkdir(1), megatools-put(1), megatools-reg(1), megatools-rm(1), megatools-copy(1).
MEGATOOLS
Part of the megatools(1) suite of commands.
BUGS
There is no upstream support for bugreports and feature requests. But you can send code patches to [email protected] ⟨mailto:[email protected]⟩ to get them integrated into upstream repository.
AUTHOR
Megatools was written by Ondrej Jirman < [email protected] ⟨mailto:[email protected]⟩ >, 2013-2022.
Official website is ⟨https://xff.cz/megatools/⟩.