1megatools-copy(1) megatools-copy(1)
2
6 megatools copy - Upload/download entire directories to/from your
7 Mega.nz account
8
10 megatools copy [-n] [--no-progress] --local <path> --remote <remotepath>
11 megatools copy [-n] [--no-progress] --download --local <path> --remote <remotepath>
12
14 Sync remote and local directories. No files are ever overwritten or re‐
15 moved.
16 Default direction is to upload files to the cloud. If you want to down‐
18 load files, you have to add --download option.
19
21 -r <remotepath> , --remote <remotepath>
22 Remote directory path.
23 -l <path> , --local <path>
25 Local directory path.
26 -d , --download
28 Download files from the Mega.nz. The default is to upload.
29 -n , --dryrun
31 Don’t perform any actual changes, just print what would be done.
32 --no-progress
34 Disable upload progress reporting.
35 --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 --disable-previews
43 Don’t generate and upload file previews. Default is to generate
44 previews.
45 --disable-resume
47 Don’t resume downloads from partially downloaded file. Default
48 is to resume.
49 -u <email> , --username <email>
51 Account username (email)
52 -p <password> , --password <password>
54 Account password
55 --no-ask-password
57 Never ask interactively for a password
58 --reload
60 Reload filesystem cache
61 --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 --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 • none : Disable proxy if it was enabled in the config file.
75 • socks5://localhost:9050 : Local SOCKSv5 proxy server
77 • socks5h://localhost:9050 : Local SOCKSv5 proxy server with DNS
79 handled by the proxy
80 --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 --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 --config <path>
93 Load configuration from a file
94 --ignore-config-file
96 Disable loading .megarc
97 --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 Available options are:
104 • http: Dump HTTP request/response details (can be used to debug
106 connection/proxy issues)
107 • api: Dump Mega.nz API calls
109 • fs: Dump Mega.nz filesystem (may require --reload to actually
111 print something)
112 • cache: Dump cache contents
114 • tman: Dump transfer manager events
116 --version
118 Show version information
119
121 • Upload directory.
122 $ megatools copy --local MyBackups --remote /Root/Backups
124 • Download directory.
126 $ megatools copy --local MyBackups --remote /Root/Backups --download
128
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 Megatools maps node tree structure to a traditional filesystem paths
135 (eg. /Root/SomeFile.DAT).
136 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 /Root/conflictingfile
143 /Root/conflictingfile.7Fdi3ZjC
144 /Root/conflictingfile.mEU23aSD
145 You need to be aware of several special folders:
147 /Root Writable directory representing the root of the filesystem.
149 /Trash Trash directory where Mega.nz web client moves deleted files.
151 This directory is not used by megatools when removing files.
152 /Inbox Not sure.
154 /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 /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
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
171 Part of the megatools(1) suite of commands.
172
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
179 Megatools was written by Ondrej Jirman < megatools@megous.com
180 ⟨mailto:megatools@megous.com⟩ >, 2013-2022.
181 Official website is ⟨http://megatools.megous.com⟩.
183 20 July 2023 megatools-copy(1)