1megatools-get(1) megatools-get(1)
2
3
4
6 megatools get - download files from your Mega.nz account
7
9 megatools get [--no-progress] [--path <path>] <remotepaths>...
10 megatools get --path - <remotefile>
11
13 Downloads files from your Mega.nz account.
14
15 NOTE: If you want to download entire directories, use megatools-
16 copy(1).
17
19 --path <path>
20 Local path to download to. If this path is a directory, files
21 are placed into the directory. If this path doesn’t exist, and
22 it’s parent directory does, the file will be downloaded to a
23 specified file (this only works if you specify exactly one re‐
24 mote path).
25
26 If <path> is -, remote file will be streamed to stdout.
27
28 --no-progress
29 Disable download progress reporting. This is implied when
30 streaming.
31
32 --disable-resume
33 Don’t resume downloads from partially downloaded file. Default
34 is to resume.
35
36 -u <email> , --username <email>
37 Account username (email)
38
39 -p <password> , --password <password>
40 Account password
41
42 --no-ask-password
43 Never ask interactively for a password
44
45 --reload
46 Reload filesystem cache
47
48 --limit-speed <speed>
49 Set maximum allowed upload and download speed in KiB/s. This
50 option overrides config file settings. 0 means no limit. When
51 using ParallelTransfers > 1, upload speed limit is applied to
52 each transfer individually.
53
54 --proxy <proxy>
55 Use proxy server to connect to mega.nz. This option overrides
56 config file settings. More information can be found in libcurl
57 documentation at ⟨https://curl.haxx.se/libcurl/c/CUR‐
58 LOPT_PROXY.html⟩. Some acceptable values are:
59
60 • none : Disable proxy if it was enabled in the config file.
61
62 • socks5://localhost:9050 : Local SOCKSv5 proxy server
63
64 • socks5h://localhost:9050 : Local SOCKSv5 proxy server with DNS
65 handled by the proxy
66
67 --netif <ifname|ip>
68 Network interface or local IP address used for outgoing connec‐
69 tions. You have to specify IP address bound to some of your lo‐
70 cal network interfaces, when specifying an IP address.
71
72 --ip-proto <proto>
73 Which IP protocol to prefer when connecting to mega.nz (v4, v6,
74 or any). This is just an advisory option. Megatools will re‐
75 solve mega.nz domain, and then use an A or AAAA record based on
76 the stated preference.
77
78 --config <path>
79 Load configuration from a file
80
81 --ignore-config-file
82 Disable loading .megarc
83
84 --debug [<options>]
85 Enable debugging of various aspects of the megatools operation.
86 You may enable multiple debugging options separated by commas.
87 (eg. --debug api,fs)
88
89 Available options are:
90
91 • http: Dump HTTP request/response details (can be used to debug
92 connection/proxy issues)
93
94 • api: Dump Mega.nz API calls
95
96 • fs: Dump Mega.nz filesystem (may require --reload to actually
97 print something)
98
99 • cache: Dump cache contents
100
101 • tman: Dump transfer manager events
102
103 --version
104 Show version information
105
106 <remotepaths>
107 One or more remote files to download.
108
109 <remotefile>
110 Remote path to a single file to stream.
111
113 • Download file to the current directory:
114
115 $ megatools ls /Root
116
117 /Root
118 /Root/README
119
120 $ megatools get /Root/README
121 $ ls
122
123 README
124
126 Mega.nz filesystem is represented as a tree of nodes of various types.
127 Nodes are identified by a 8 character node handles (eg. 7Fdi3ZjC).
128 Structure of the filesystem is not encrypted.
129
130 Megatools maps node tree structure to a traditional filesystem paths
131 (eg. /Root/SomeFile.DAT).
132
133 NOTE: By the nature of Mega.nz storage, several files in the directory
134 can have the same name. To allow access to such files, the names of
135 conflicting files are extended by appending dot and their node handle
136 like this:
137
138 /Root/conflictingfile
139 /Root/conflictingfile.7Fdi3ZjC
140 /Root/conflictingfile.mEU23aSD
141
142 You need to be aware of several special folders:
143
144 /Root Writable directory representing the root of the filesystem.
145
146 /Trash Trash directory where Mega.nz web client moves deleted files.
147 This directory is not used by megatools when removing files.
148
149 /Inbox Not sure.
150
151 /Contacts
152 Directory containing subdirectories representing your contacts
153 list. If you want to add contacts to the list, simply create
154 subdirectory named after the contact you want to add.
155
156 /Contacts/<email>
157 Directories representing individual contacts in your contacts
158 list. These directories contain folders that others shared with
159 you. All shared files are read-only, at the moment.
160
162 megatools(1), megarc(5), megatools-df(1), megatools-dl(1), megatools-
163 get(1), megatools-ls(1), megatools-mkdir(1), megatools-put(1), mega‐
164 tools-reg(1), megatools-rm(1), megatools-copy(1).
165
167 Part of the megatools(1) suite of commands.
168
170 Report bugs to megatools@megous.com ⟨mailto:megatools@megous.com⟩ .
171 Your message will end up in a public archive, so be careful what you
172 say or send.
173
175 Megatools was written by Ondrej Jirman < megatools@megous.com
176 ⟨mailto:megatools@megous.com⟩ >, 2013-2022.
177
178 Official website is ⟨http://megatools.megous.com⟩.
179
180
181
182 20 July 2023 megatools-get(1)