'\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH megatools 1 "14 April 2020" "" ""
.SH NAME
megatools \- Mega.nz command line tools
.SH SYNOPSIS
.RS 
.nf
\fImegatools df\fR [\-\-free|\-\-total|\-\-used] [\-\-mb|\-\-gb|\-h]
\fImegatools ls\fR [\-e] [\-h] [\-\-header] [\-l] [\-R] [\-n] [<remotepaths>\&...]
\fImegatools test\fR [\-f|\-d] <remotepaths>\&...
\fImegatools export\fR <remotepaths>\&...
\fImegatools put\fR [\-\-no\-progress] [\-\-path <remotepath>] <paths>\&...
\fImegatools mkdir\fR <remotepaths>\&...
\fImegatools mkdir\fR /Contacts/<contactemail>
\fImegatools get\fR [\-\-no\-progress] [\-\-path <path>] <remotepaths>\&...
\fImegatools get\fR \-\-path \- <remotefile>
\fImegatools copy\fR [\-n] [\-\-no\-progress] \-\-local <path> \-\-remote <remotepath>
\fImegatools copy\fR [\-n] [\-\-no\-progress] \-\-download \-\-local <path> \-\-remote <remotepath>
\fImegatools rm\fR <remotepaths>\&...
\fImegatools rm\fR /Contacts/<contactemail>
\fImegatools dl\fR [\-\-no\-progress] [\-\-path <path>] <links>\&...
\fImegatools dl\fR \-\-path \- <filelink>
\fImegatools reg\fR [\-\-scripted] \-\-register \-\-email <email> \-\-name <realname> \-\-password <password>
\fImegatools reg\fR [\-\-scripted] \-\-verify <state> <link>
.fi
.RE
.SH DESCRIPTION
Megatools is a collection of programs for accessing Mega service from
a command line of your desktop or server.
.PP
Megatools allow you to copy individual files as well as entire directory
trees to and from the cloud. You can also perform streaming downloads for
example to preview videos and audio files, without needing to download
the entire file.
.PP
Megatools are robust and optimized for fast operation - as fast as Mega
servers allow. Memory requirements and CPU utilization are kept at minimum.
.PP
You can register account using a \fBmegatools-reg\fR(1) tool, with the benefit of having
true control of your encryption keys.
.PP
Mega website can be found at \(lahttp://mega.nz\(ra.
.PP
Megatools can be downloaded at \(lahttp://megatools.megous.com\(ra
.SH "TOOLS OVERVIEW"
.TP 
\fBmegatools-reg\fR(1) 
Register and verify a new mega account
.TP 
\fBmegatools-df\fR(1) 
Show your cloud storage space usage/quota
.TP 
\fBmegatools-ls\fR(1) 
List all remote files
.TP 
\fBmegatools-test\fR(1) 
Test for existence of files or folders
.TP 
\fBmegatools-export\fR(1) 
Create public links for remote files
.TP 
\fBmegatools-mkdir\fR(1) 
Create remote directory
.TP 
\fBmegatools-rm\fR(1) 
Remove remote file or directory
.TP 
\fBmegatools-put\fR(1) 
Upload individual files
.TP 
\fBmegatools-get\fR(1) 
Download individual files
.TP 
\fBmegatools-dl\fR(1) 
Download file from a "public" Mega link (doesn\(cqt require login)
.TP 
\fBmegatools-copy\fR(1) 
Upload or download a directory tree
.SH "CONFIGURATION FILES"
See \fBmegarc\fR(5) for information about mega configuration file.
.PP
Each of the individual tools have help that can be accessed using --help
parameter.
.SH "SESSION CACHE"
If you modify cloud filesystem from the Mega.nz website or from another computer,
you\(cqll need to refresh your session cache. This can be done by using the
--reload option to any tool, or by waiting for a cache timeout (default timeout is set to 10 minutes).
.SH "REMOTE FILESYSTEM"
Mega.nz filesystem is represented as a tree of nodes of various types. Nodes
are identified by a 8 character node handles (eg. \*(T<7Fdi3ZjC\*(T>). Structure of the
filesystem is not encrypted.
.PP
Megatools maps node tree structure to a traditional filesystem paths (eg.
\*(T</Root/SomeFile.DAT\*(T>).
.PP
\fBNOTE\fR: By the nature of Mega.nz storage, several files in the directory can
have the same name. To allow access to such files, the names of conflicting
files are extended by appending dot and their node handle like this:
.PP
.nf
\*(T</Root/conflictingfile
/Root/conflictingfile.7Fdi3ZjC
/Root/conflictingfile.mEU23aSD\*(T>
.fi
.PP
You need to be aware of several special folders:
.TP 
/Root 
Writable directory representing the root of the filesystem.
.TP 
/Trash 
Trash directory where Mega.nz web client moves deleted files. This
directory is not used by megatools when removing files.
.TP 
/Inbox 
Not sure.
.TP 
/Contacts 
Directory containing subdirectories representing your contacts list. If
you want to add contacts to the list, simply create subdirectory named
after the contact you want to add.
.TP 
/Contacts/<email> 
Directories representing individual contacts in your contacts list. These
directories contain folders that others shared with you. All shared
files are read-only, at the moment.
.SH "SEE ALSO"
\fBmegatools\fR(1),
\fBmegarc\fR(5),
\fBmegatools-df\fR(1),
\fBmegatools-dl\fR(1),
\fBmegatools-get\fR(1),
\fBmegatools-ls\fR(1),
\fBmegatools-mkdir\fR(1),
\fBmegatools-put\fR(1),
\fBmegatools-reg\fR(1),
\fBmegatools-rm\fR(1),
\fBmegatools-copy\fR(1).
.SH MEGATOOLS
Part of the \fBmegatools\fR(1) suite of commands.
.SH BUGS
Report bugs to 
.URL mailto:megatools@megous.com megatools@megous.com
\&. Your message will end up in a public
archive, so be careful what you say or send.
.SH AUTHOR
Megatools was written by Ondrej Jirman <
.URL mailto:megatools@megous.com megatools@megous.com
>, 2013-2019.
.PP
Official website is \(lahttp://megatools.megous.com\(ra.