1megatools-copy(1)                                            megatools-copy(1)
2
3
4

NAME

6       megatools  copy  -  Upload/download  entire  directories  to/from  your
7       Mega.nz account
8

SYNOPSIS

10              megatools copy [-n] [--no-progress] --local <path> --remote <remotepath>
11              megatools copy [-n] [--no-progress] --download --local <path> --remote <remotepath>
12

DESCRIPTION

14       Sync remote and local directories. No files are ever overwritten or re‐
15       moved.
16
17       Default direction is to upload files to the cloud. If you want to down‐
18       load files, you have to add --download option.
19

OPTIONS

21       -r <remotepath> , --remote <remotepath>
22              Remote directory path.
23
24       -l <path> , --local <path>
25              Local directory path.
26
27       -d , --download
28              Download files from the Mega.nz. The default is to upload.
29
30       -n , --dryrun
31              Don’t perform any actual changes, just print what would be done.
32
33       --no-progress
34              Disable upload progress reporting.
35
36       --enable-previews
37              Generate and upload file previews,  when  uploading  new  files.
38              This  is the default, unless you changed it in the configuration
39              file. Use this to override the  option  from  the  configuration
40              file.
41
42       --disable-previews
43              Don’t  generate and upload file previews. Default is to generate
44              previews.
45
46       --disable-resume
47              Don’t resume downloads from partially downloaded  file.  Default
48              is to resume.
49
50       -u <email> , --username <email>
51              Account username (email)
52
53       -p <password> , --password <password>
54              Account password
55
56       --no-ask-password
57              Never ask interactively for a password
58
59       --reload
60              Reload filesystem cache
61
62       --limit-speed <speed>
63              Set  maximum  allowed  upload and download speed in KiB/s.  This
64              option overrides config file settings. 0 means no  limit.   When
65              using  ParallelTransfers  >  1, upload speed limit is applied to
66              each transfer individually.
67
68       --proxy <proxy>
69              Use proxy server to connect to mega.nz.  This  option  overrides
70              config  file settings.  More information can be found in libcurl
71              documentation      at       ⟨https://curl.haxx.se/libcurl/c/CUR
72              LOPT_PROXY.html⟩.  Some acceptable values are:
73
74              • none : Disable proxy if it was enabled in the config file.
75
76              • socks5://localhost:9050 : Local SOCKSv5 proxy server
77
78              • socks5h://localhost:9050 : Local SOCKSv5 proxy server with DNS
79                handled by the proxy
80
81       --netif <ifname|ip>
82              Network interface or local IP address used for outgoing  connec‐
83              tions.  You have to specify IP address bound to some of your lo‐
84              cal network interfaces, when specifying an IP address.
85
86       --ip-proto <proto>
87              Which IP protocol to prefer when connecting to mega.nz (v4,  v6,
88              or  any).   This is just an advisory option.  Megatools will re‐
89              solve mega.nz domain, and then use an A or AAAA record based  on
90              the stated preference.
91
92       --config <path>
93              Load configuration from a file
94
95       --ignore-config-file
96              Disable loading .megarc
97
98       --debug [<options>]
99              Enable  debugging of various aspects of the megatools operation.
100              You may enable multiple debugging options separated  by  commas.
101              (eg. --debug api,fs)
102
103              Available options are:
104
105              • http: Dump HTTP request/response details (can be used to debug
106                connection/proxy issues)
107
108              • api: Dump Mega.nz API calls
109
110              • fs: Dump Mega.nz filesystem (may require --reload to  actually
111                print something)
112
113              • cache: Dump cache contents
114
115              • tman: Dump transfer manager events
116
117       --version
118              Show version information
119

EXAMPLES

121       • Upload directory.
122
123         $ megatools copy --local MyBackups --remote /Root/Backups
124
125       • Download directory.
126
127         $ megatools copy --local MyBackups --remote /Root/Backups --download
128

REMOTE FILESYSTEM

130       Mega.nz  filesystem is represented as a tree of nodes of various types.
131       Nodes are identified by a 8  character  node  handles  (eg.  7Fdi3ZjC).
132       Structure of the filesystem is not encrypted.
133
134       Megatools  maps  node  tree structure to a traditional filesystem paths
135       (eg.  /Root/SomeFile.DAT).
136
137       NOTE: By the nature of Mega.nz storage, several files in the  directory
138       can  have  the  same  name. To allow access to such files, the names of
139       conflicting files are extended by appending dot and their  node  handle
140       like this:
141
142       /Root/conflictingfile
143       /Root/conflictingfile.7Fdi3ZjC
144       /Root/conflictingfile.mEU23aSD
145
146       You need to be aware of several special folders:
147
148       /Root  Writable directory representing the root of the filesystem.
149
150       /Trash Trash  directory  where  Mega.nz web client moves deleted files.
151              This directory is not used by megatools when removing files.
152
153       /Inbox Not sure.
154
155       /Contacts
156              Directory containing subdirectories representing  your  contacts
157              list.  If  you  want  to add contacts to the list, simply create
158              subdirectory named after the contact you want to add.
159
160       /Contacts/<email>
161              Directories representing individual contacts  in  your  contacts
162              list.  These directories contain folders that others shared with
163              you. All shared files are read-only, at the moment.
164

SEE ALSO

166       megatools(1), megarc(5), megatools-df(1),  megatools-dl(1),  megatools-
167       get(1),  megatools-ls(1),  megatools-mkdir(1),  megatools-put(1), mega‐
168       tools-reg(1), megatools-rm(1), megatools-copy(1).
169

MEGATOOLS

171       Part of the megatools(1) suite of commands.
172

BUGS

174       Report bugs  to  megatools@megous.com  ⟨mailto:megatools@megous.com⟩  .
175       Your  message  will  end up in a public archive, so be careful what you
176       say or send.
177

AUTHOR

179       Megatools was written by Ondrej Jirman < megatools@megous.com
180       ⟨mailto:megatools@megous.com⟩ >, 2013-2022.
181
182       Official website is ⟨http://megatools.megous.com⟩.
183
184
185
186                                 20 July 2023                megatools-copy(1)
Impressum