1MEGALS(1) Megatools Manual MEGALS(1)
2
6 megals - List files stored in the cloud
7
9 megals [-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 columns.
26 --long, -l
28 List additional information about listed filesystem nodes. Node
29 handle, owner, node type, file size, and the last modification
30 date.
31 --recursive, -R
33 List directories recursively. This is the default if no paths are
34 specified.
35 --names, -n
37 Show only names of nodes within the directory. This option has
38 effect only if you specified a single path on a command line.
39 --print0, -0
41 Separate file names with NULs instead of new lines.
42 -u <email>, --username <email>
44 Account username (email)
45 -p <password>, --password <password>
47 Account password
48 --no-ask-password
50 Never ask interactively for a password
51 --reload
53 Reload filesystem cache
54 --limit-speed <speed>
56 Set maximum allowed upload and download speed in KiB/s. This option
57 overrides config file settings. 0 means no limit. When using
58 ParallelTransfers > 1, upload speed limit is applied to each
59 transfer individually.
60 --proxy <proxy>
62 Use proxy server to connect to mega.nz. This option overrides
63 config file settings. More information can be found in libcurl
64 documentation at https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html.
65 Some acceptable values are:
66 · none : Disable proxy if it was enabled in the config file.
68 · socks5://localhost:9050 : Local SOCKSv5 proxy server
70 · socks5h://localhost:9050 : Local SOCKSv5 proxy server with DNS
72 handled by the proxy
73 --config <path>
75 Load configuration from a file
76 --ignore-config-file
78 Disable loading .megarc
79 --debug [<options>]
81 Enable debugging of various aspects of the megatools operation. You
82 may enable multiple debugging options separated by commas. (eg.
83 --debug api,fs)
84 Available options are:
86 · http: Dump HTTP request/response details (can be used to debug
88 connection/proxy issues)
89 · api: Dump Mega.nz API calls
91 · fs: Dump Mega.nz filesystem (may require --reload to actually
93 print something)
94 · cache: Dump cache contents
96 · tman: Dump transfer manager events
98 --version
100 Show version information
101 <remotepaths>
103 One or more remote filesystem paths to list. If path points to a
104 directory, contents of the directory and the directory itself is
105 listed. When --names is given, only the contents of the directory
106 is listed.
107 If path points to a file, the file itself is listed.
109 If ommited, the entire remote filesystem is listed recursively.
111
113 · List all files:
114 $ megals
116 /Contacts
118 /Inbox
119 /Root
120 /Root/README
121 /Root/bigfile
122 /Trash
123 · List all files in the /Root, recursively and with details:
125 $ megals -l /Root
127 3RsS2QwJ 2 - 2013-01-22 12:31:06 /Root
129 2FFSiaKZ Xz2tWWB5Dmo 0 2686 2013-04-15 08:33:47 /Root/README
130 udtDgR7I Xz2tWWB5Dmo 0 4405067776 2013-04-10 19:16:02 /Root/bigfile
131 · List all files in the /Root, recursively and with details, show
133 only file names:
134 $ megals -ln /Root
136 2FFSiaKZ Xz2tWWB5Dmo 0 2686 2013-04-15 08:33:47 README
138 udtDgR7I Xz2tWWB5Dmo 0 4405067776 2013-04-10 19:16:02 bigfile
139 · Export download links:
141 $ megals -e /Root/README
143 https://mega.nz/#!OFFRlbgR!k5rWmLp3mxB0gsq07Ii67PLd9L0wq4KondFLDlfH3Uw /Root/README
145 · List files in a more human readable format:
147 $ megals -hnl --header /Root/README
149 ===================================================================================
151 Handle Owner T Size Mod. Date Filename
152 ===================================================================================
153 2FFSiaKZ Xz2tWWB5Dmo 0 2.6 KiB 2013-04-15 08:33:47 README
154
156 Mega.nz filesystem is represented as a tree of nodes of various types.
157 Nodes are identified by a 8 character node handles (eg. 7Fdi3ZjC).
158 Structure of the filesystem is not encrypted.
159 Megatools maps node tree structure to a traditional filesystem paths
161 (eg. /Root/SomeFile.DAT).
162 NOTE: By the nature of Mega.nz storage, several files in the directory
164 can have the same name. To allow access to such files, the names of
165 conflicting files are extended by appending dot and their node handle
166 like this:
167 /Root/conflictingfile
169 /Root/conflictingfile.7Fdi3ZjC
170 /Root/conflictingfile.mEU23aSD
171 You need to be aware of several special folders:
173 /Root
175 Writable directory representing the root of the filesystem.
176 /Trash
178 Trash directory where Mega.nz web client moves deleted files. This
179 directory is not used by megatools when removing files.
180 /Inbox
182 Not sure.
183 /Contacts
185 Directory containing subdirectories representing your contacts
186 list. If you want to add contacts to the list, simply create
187 subdirectory named after the contact you want to add.
188 /Contacts/<email>
190 Directories representing individual contacts in your contacts list.
191 These directories contain folders that others shared with you. All
192 shared files are read-only, at the moment.
193
195 megatools(7), megarc(5), megadf(1), megadl(1), megaget(1), megals(1),
196 megamkdir(1), megaput(1), megareg(1), megarm(1), megacopy(1).
197
199 Part of the megatools(7) suite.
200
202 Report bugs at https://github.com/megous/megatools or
203 megous@megous.com.
204
206 Megatools was written by Ondrej Jirman <megous@megous.com>, 2013-2016.
207 Official website is http://megatools.megous.com.
209megatools 1.10.2 07/31/2018 MEGALS(1)