1megatools-ls(1) megatools-ls(1)
2
6 megatools ls - List files stored in the cloud
7
9 megatools ls [-e] [-h] [--header] [-l] [-R] [-n] [<remotepaths>...]
10
12 Lists files stored on Mega.nz, exports public download links.
13
15 --export , -e
16 For all files that are going to be listed, also display public
17 download link with file key.
18 NOTE: Folders export doesn’t work yet.
20 --human , -h
22 Display file sizes in a human readable format.
23 --header
25 For long list format, display header describing all listed col‐
26 umns.
27 --long , -l
29 List additional information about listed filesystem nodes. Node
30 handle, owner, node type, file size, and the last modification
31 date.
32 --recursive , -R
34 List directories recursively. This is the default if no paths
35 are specified.
36 --names , -n
38 Show only names of nodes within the directory. This option has
39 effect only if you specified a single path on a command line.
40 --print0 , -0
42 Separate file names with NULs instead of new lines.
43 -u <email> , --username <email>
45 Account username (email)
46 -p <password> , --password <password>
48 Account password
49 --no-ask-password
51 Never ask interactively for a password
52 --reload
54 Reload filesystem cache
55 --limit-speed <speed>
57 Set maximum allowed upload and download speed in KiB/s. This
58 option overrides config file settings. 0 means no limit. When
59 using ParallelTransfers > 1, upload speed limit is applied to
60 each transfer individually.
61 --proxy <proxy>
63 Use proxy server to connect to mega.nz. This option overrides
64 config file settings. More information can be found in libcurl
65 documentation at ⟨https://curl.haxx.se/libcurl/c/CUR‐
66 LOPT_PROXY.html⟩. Some acceptable values are:
67 • none : Disable proxy if it was enabled in the config file.
69 • socks5://localhost:9050 : Local SOCKSv5 proxy server
71 • socks5h://localhost:9050 : Local SOCKSv5 proxy server with DNS
73 handled by the proxy
74 --netif <ifname|ip>
76 Network interface or local IP address used for outgoing connec‐
77 tions. You have to specify IP address bound to some of your lo‐
78 cal network interfaces, when specifying an IP address.
79 --ip-proto <proto>
81 Which IP protocol to prefer when connecting to mega.nz (v4, v6,
82 or any). This is just an advisory option. Megatools will re‐
83 solve mega.nz domain, and then use an A or AAAA record based on
84 the stated preference.
85 --config <path>
87 Load configuration from a file
88 --ignore-config-file
90 Disable loading .megarc
91 --debug [<options>]
93 Enable debugging of various aspects of the megatools operation.
94 You may enable multiple debugging options separated by commas.
95 (eg. --debug api,fs)
96 Available options are:
98 • http: Dump HTTP request/response details (can be used to debug
100 connection/proxy issues)
101 • api: Dump Mega.nz API calls
103 • fs: Dump Mega.nz filesystem (may require --reload to actually
105 print something)
106 • cache: Dump cache contents
108 • tman: Dump transfer manager events
110 --version
112 Show version information
113 <remotepaths>
115 One or more remote filesystem paths to list. If path points to a
116 directory, contents of the directory and the directory itself is
117 listed. When --names is given, only the contents of the direc‐
118 tory is listed.
119 If path points to a file, the file itself is listed.
121 If omitted, the entire remote filesystem is listed recursively.
123
125 • List all files:
126 $ megatools ls
128 /Contacts
130 /Inbox
131 /Root
132 /Root/README
133 /Root/bigfile
134 /Trash
135 • List all files in the /Root, recursively and with details:
137 $ megatools ls -l /Root
139 3RsS2QwJ 2 - 2013-01-22 12:31:06 /Root
141 2FFSiaKZ Xz2tWWB5Dmo 0 2686 2013-04-15 08:33:47 /Root/README
142 udtDgR7I Xz2tWWB5Dmo 0 4405067776 2013-04-10 19:16:02 /Root/bigfile
143 • List all files in the /Root, recursively and with details, show only
145 file names:
146 $ megatools ls -ln /Root
148 2FFSiaKZ Xz2tWWB5Dmo 0 2686 2013-04-15 08:33:47 README
150 udtDgR7I Xz2tWWB5Dmo 0 4405067776 2013-04-10 19:16:02 bigfile
151 • Export download links:
153 $ megatools ls -e /Root/README
155 https://mega.nz/#!OFFRlbgR!k5rWmLp3mxB0gsq07Ii67PLd9L0wq4KondFLDlfH3Uw /Root/README
157 • List files in a more human readable format:
159 $ megatools ls -hnl --header /Root/README
161 ===================================================================================
163 Handle Owner T Size Mod. Date Filename
164 ===================================================================================
165 2FFSiaKZ Xz2tWWB5Dmo 0 2.6 KiB 2013-04-15 08:33:47 README
166
168 Mega.nz filesystem is represented as a tree of nodes of various types.
169 Nodes are identified by a 8 character node handles (eg. 7Fdi3ZjC).
170 Structure of the filesystem is not encrypted.
171 Megatools maps node tree structure to a traditional filesystem paths
173 (eg. /Root/SomeFile.DAT).
174 NOTE: By the nature of Mega.nz storage, several files in the directory
176 can have the same name. To allow access to such files, the names of
177 conflicting files are extended by appending dot and their node handle
178 like this:
179 /Root/conflictingfile
181 /Root/conflictingfile.7Fdi3ZjC
182 /Root/conflictingfile.mEU23aSD
183 You need to be aware of several special folders:
185 /Root Writable directory representing the root of the filesystem.
187 /Trash Trash directory where Mega.nz web client moves deleted files.
189 This directory is not used by megatools when removing files.
190 /Inbox Not sure.
192 /Contacts
194 Directory containing subdirectories representing your contacts
195 list. If you want to add contacts to the list, simply create
196 subdirectory named after the contact you want to add.
197 /Contacts/<email>
199 Directories representing individual contacts in your contacts
200 list. These directories contain folders that others shared with
201 you. All shared files are read-only, at the moment.
202
204 megatools(1), megarc(5), megatools-df(1), megatools-dl(1), megatools-
205 get(1), megatools-ls(1), megatools-mkdir(1), megatools-put(1), mega‐
206 tools-reg(1), megatools-rm(1), megatools-copy(1).
207
209 Part of the megatools(1) suite of commands.
210
212 Report bugs to megatools@megous.com ⟨mailto:megatools@megous.com⟩ .
213 Your message will end up in a public archive, so be careful what you
214 say or send.
215
217 Megatools was written by Ondrej Jirman < megatools@megous.com
218 ⟨mailto:megatools@megous.com⟩ >, 2013-2022.
219 Official website is ⟨http://megatools.megous.com⟩.
221 20 July 2023 megatools-ls(1)