1MEGALS(1)                      Megatools Manual                      MEGALS(1)
2
3
4

NAME

6       megals - List files stored in the cloud
7

SYNOPSIS

9       megals [-e] [-h] [--header] [-l] [-R] [-n] [<remotepaths>...]
10

DESCRIPTION

12       Lists files stored on Mega.nz, exports public download links.
13

OPTIONS

15       --export, -e
16           For all files that are going to be listed, also display public
17           download link with file key.
18
19           NOTE: Folders export doesn’t work yet.
20
21       --human, -h
22           Display file sizes in a human readable format.
23
24       --header
25           For long list format, display header describing all listed columns.
26
27       --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
32       --recursive, -R
33           List directories recursively. This is the default if no paths are
34           specified.
35
36       --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
40       --print0, -0
41           Separate file names with NULs instead of new lines.
42
43       -u <email>, --username <email>
44           Account username (email)
45
46       -p <password>, --password <password>
47           Account password
48
49       --no-ask-password
50           Never ask interactively for a password
51
52       --reload
53           Reload filesystem cache
54
55       --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
61       --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
67           ·   none : Disable proxy if it was enabled in the config file.
68
69           ·   socks5://localhost:9050 : Local SOCKSv5 proxy server
70
71           ·   socks5h://localhost:9050 : Local SOCKSv5 proxy server with DNS
72               handled by the proxy
73
74       --config <path>
75           Load configuration from a file
76
77       --ignore-config-file
78           Disable loading .megarc
79
80       --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
85           Available options are:
86
87           ·   http: Dump HTTP request/response details (can be used to debug
88               connection/proxy issues)
89
90           ·   api: Dump Mega.nz API calls
91
92           ·   fs: Dump Mega.nz filesystem (may require --reload to actually
93               print something)
94
95           ·   cache: Dump cache contents
96
97           ·   tman: Dump transfer manager events
98
99       --version
100           Show version information
101
102       <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
108               If path points to a file, the file itself is listed.
109
110               If ommited, the entire remote filesystem is listed recursively.
111

EXAMPLES

113       ·   List all files:
114
115               $ megals
116
117               /Contacts
118               /Inbox
119               /Root
120               /Root/README
121               /Root/bigfile
122               /Trash
123
124       ·   List all files in the /Root, recursively and with details:
125
126               $ megals -l /Root
127
128               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
132       ·   List all files in the /Root, recursively and with details, show
133           only file names:
134
135               $ megals -ln /Root
136
137               2FFSiaKZ    Xz2tWWB5Dmo 0          2686 2013-04-15 08:33:47 README
138               udtDgR7I    Xz2tWWB5Dmo 0    4405067776 2013-04-10 19:16:02 bigfile
139
140       ·   Export download links:
141
142               $ megals -e /Root/README
143
144               https://mega.nz/#!OFFRlbgR!k5rWmLp3mxB0gsq07Ii67PLd9L0wq4KondFLDlfH3Uw /Root/README
145
146       ·   List files in a more human readable format:
147
148               $ megals -hnl --header /Root/README
149
150               ===================================================================================
151               Handle      Owner       T          Size Mod. Date           Filename
152               ===================================================================================
153               2FFSiaKZ    Xz2tWWB5Dmo 0       2.6 KiB 2013-04-15 08:33:47 README
154

REMOTE FILESYSTEM

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
160       Megatools maps node tree structure to a traditional filesystem paths
161       (eg. /Root/SomeFile.DAT).
162
163       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
168           /Root/conflictingfile
169           /Root/conflictingfile.7Fdi3ZjC
170           /Root/conflictingfile.mEU23aSD
171
172       You need to be aware of several special folders:
173
174       /Root
175           Writable directory representing the root of the filesystem.
176
177       /Trash
178           Trash directory where Mega.nz web client moves deleted files. This
179           directory is not used by megatools when removing files.
180
181       /Inbox
182           Not sure.
183
184       /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
189       /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

SEE ALSO

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

MEGATOOLS

199       Part of the megatools(7) suite.
200

BUGS

202       Report bugs at https://github.com/megous/megatools or
203       megous@megous.com.
204

AUTHOR

206       Megatools was written by Ondrej Jirman <megous@megous.com>, 2013-2016.
207
208       Official website is http://megatools.megous.com.
209
210
211
212megatools 1.10.2                  04/15/2020                         MEGALS(1)
Impressum