/
readme.txt
241 lines (187 loc) · 9.44 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
_____ _
_____ _ _| |___ _____ _____ ___ ___ _| |___ ___
| | | | --| . | | | .'| | . | -_| _|
|_|_|_|___|_____|___|_|_|_|_|_|_|__,|_|_|___|___|_|
------------------
muCommander v0.9.8
------------------
muCommander is a lightweight, cross-platform file manager with a dual-pane interface.
It runs on any operating system with Java support (macOS, Windows, Linux, *BSD, Solaris...).
Please visit the muCommander project page on GitHub (https://github.com/mucommander) to ask questions,
suggest features, report a bug or browse documentation. Your feedback is always welcome!
Official website: http://www.mucommander.com
Requirements
------------
A Java Runtime Environment (JRE) 8 or later is required to run muCommander.
Java 11 is recommended, you can download it at https://www.oracle.com/technetwork/java/javase/downloads/.
If you're having problems launching muCommander, make sure the JAVA_HOME environment variable points to the directory
where your Java runtime is installed.
What's new since v0.9.7 ?
-----------------------
New features:
-
Improvements:
- Mouse clicks on the headers of a file table (e.g., NAME, SIZE, DATE) are better detected.
- Require non-headless Java when installing from RPM.
- Use absolute path rather than canonical path in bookmarks to avoid resolving symbolic links.
- Tar archives with headers in the pax format are now supported.
- The free space indicator in the status bar is updated right after relevant events like switching to the application.
- Symbolic links are unpacked from tar archives.
- The portable version stores preferences files in the installation directory.
- It is now possible to change the modification date of multiple search results.
- Prevention of ZipSlip (https://snyk.io/research/zip-slip-vulnerability)
Localization:
- Updated Russian translation
Bug fixes:
- Fix installation using GDebi Package Installer
- Permanent deletion of symbolic links on Windows no longer deletes their linked content.
- Restore file table configuration (column visibility, width and position) on startup also when custom folders are set.
- The default keyboard shortcut for packing files (CTRL+I) opens the 'Pack files' dialog on macOS.
- File search works with search strings that resemble a path to an archive file, e.g., find:///home/*.zip.
Known issues:
- Mac OS X: "muCommander damaged and cannot be opened" may appear after downloading muCommander from the browser. This
can be solved by executing: xattr -d com.apple.quarantine <jar_name>.jar
- Some translations may not be up-to-date.
- Mac OS X: "Do you want the application "muCommander.app" to accept incoming network connections?" dialog keeps popping
up on startup even if the dialog has been previously accepted (ticket #339), when 'Bonjour' support is enabled.
- SMB support may not work properly on non multi-language JRE.
- 'Copy files to clipboard' not working with some applications (files are not pasted).
- Mac OS X: some keyboard shortcuts may conflict with global system shortcuts.
- Authentication issues when using several sets of credentials (login/password) for the same server.
- Untrusted HTTPS connections are allowed without a warning.
- Windows Vista/7: "java.net.SocketException: Permission denied: recv failed" error can appear when trying to access FTP
sites. This seems to be a Windows firewall problem, with a possible workaround:
http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=7077696
- Unpacking files from 7z archive files can be slow.
- Need to enable NTLM authentication manually in order to authenticate to Samba >= 4.5. This is done by adding 'ntlm auth = yes' to smb.conf.
- Version 5.0 of RAR is not supported. Such archives would appear empty.
- Issues with browsing Documents/Desktop/Downloads on macOS may be solved by resetting Security and Privacy settings.
See https://github.com/mucommander/mucommander/wiki/Reset-Security-&-Privacy-Settings-on-macOS for more details.
- Mac OS X: muCommander may not be able to start on version <= 10.10 (OS X Yosemite) due to incompatibility of the bundled JRE.
This can be solved by installing Java 8 and running '/Applications/muCommander.app/Contents/replace_jre.sh'.
License
-------
muCommander is released under the terms of the GNU General Public License.
Please refer to the 'license.txt' file bundled with muCommander.
muCommander uses the following great third party works :
- the Gradle library released under the Apache License.
Gradle can be found at http:/gradle.org .
- Apache Commons libraries released under the Apache License.
Apache Commons can be found at http://commons.apache.org .
- Apache Hadoop released under the Apache License.
Apache Hadoop can be found at http://hadoop.apache.org .
- the Furbelow library released under the GNU LGPL.
Furbelow can be found at http://sourceforge.net/projects/furbelow .
- the ICU4J library released under the ICU License.
the ICU project can be found at http://icu-project.org .
- the JSCH library released under the BSD license.
JSCH can be found at http://www.jcraft.com/jsch/ .
- the J7Zip library released under the GNU LGPL.
J7Zip can be found at http://sourceforge.net/projects/p7zip/ .
- the jCIFS library released under the GNU LGPL.
jCIFS can be found at http://jcifs.samba.org .
- the JetS3t library released under the Apache License.
JetS3t can be found at http://jets3t.s3.amazonaws.com/index.html .
- the JmDNS library released under the GNU LGPL.
JmDNS can be found at http://jmdns.sourceforge.net .
- the JNA library released under the GNU LGPL.
JmDNS can be found at http://jna.dev.java.net .
- the JUnRar library released as Freeware.
JUnRar can be found at http://sourceforge.net/projects/java-unrar .
- the Yanfs library released under the BSD license.
Yanfs can be found at http://yanfs.dev.java.net .
- the JCommander library released under the Apache License.
JCommander can be found at http://jcommander.org .
- the ICEpdf library released under the Apache License.
ICEpdf can be found at http://www.icesoft.com/icepdf .
- the Unix4j library released under the MIT License.
Unix4j can be found at http://unix4j.org/.
- Icons by Mark James released under the Creative Commons Attribution License.
Mark James can be found at http://famfamfam.com .
Credits
-------
Core developers:
- Maxence Bernard
- Nicolas Rinaudo
- Arik Hadas
- Mariusz Jakubowski
Contributors:
- Ivan Baidakov
- Vassil Dichev
- Karel Klic
- David Kovar
- Joshua Lebo
- LeO
- Xavier Martin
- Alejandro Scandroli
- Alexander Yerenkow
- Johann Schmitz
- Thomas Uebel
- Tomer Gabel
Translators:
- Frank Berger and Tony Klüver (German)
- Marcos Cobeña and Xavi Miró (Spanish)
- Jaromír Mára and Peter Vasko (Czech)
- Kent Hsu (Traditional Chinese)
- Jioh L. Jung (Korean)
- Andrzej Kosiński (Polish)
- György Varga and Tamás Balogh-Walder (Hungarian)
- 4X_Pro and Evgeny Morozov (Russian)
- whiteriver and Woodie (Simplified Chinese)
- Joze Kovacic (Slovenian)
- Catalin Hritcu (Romanian)
- Roberto Angeletti (Italian)
- Cristiano Duarte (Brazilian Portuguese)
- Pieter Kristensen (Dutch)
- Ján Ľudvík (Slovak)
- Jonathan Murphy (British English)
- Nardog (Japanese)
- Jakob Ekström (Swedish)
- Jeppe Toustrup (Danish)
- Mykola Bilovus (Ukrainian)
- ChArLoK_16 (Arabic)
- vboo (Belarusian)
- Ingrid Amundsen (Norwegian)
- Emre Aytaç (Turkish)
- Jordi Plantalech (Catalan)
Special thanks:
- Semyon Filippov (muCommander icon)
- Stefano Perelli (former muCommander icon)
Many thanks to all of you who suggested new features, reported bugs, sent warm emails or generously donated to the
project !
Command Line Interface
----------------------
muCommander comes with a few command line switches.
The following options are available:
-a FILE, --assoc FILE Load associations from FILE.
-b FILE, --bookmarks FILE Load bookmarks from FILE.
-c FILE, --configuration FILE Load configuration from FILE
-C FILE, --commandbar FILE Load command bar from FILE.
-e FOLDER, --extensions FOLDER Load extensions from FOLDER.
-f FILE, --commands FILE Load custom commands from FILE.
-i, --ignore-warnings Do not fail on warnings (default).
-k FILE, --keymap FILE Load keymap from FILE
-p FOLDER, --preferences FOLDER Store configuration files in FOLDER
-S, --silent Do not print verbose error messages
-s FILE, --shell-history FILE Load shell history from FILE
-t FILE, --toolbar FILE Load toolbar from FILE
-u FILE, --credentials FILE Load credentials from FILE
-h, --help Print the help text and exit
-v, --version Print the version and exit
-V, --verbose Print verbose error messages (default)
-w, --fail-on-warnings Quits when a warning is encountered during
the boot process.
In addition to these, muCommander will interpret anything that comes after the last switch as a URI and load it in
its windows.
So for example:
mucommander -b ~/.bookmarks.xml ftp://user@myftp.com ~/dev http://slashdot.org
Will:
- read bookmarks from ~/bookmarks.xml
- load a connection to myftp.com in the left panel of the main window
- load ~/dev in the right panel of the main window
- open a second window and load http://slashdot.org in its left panel
- load the default directory in the second window's fourth panel
Documentation
-------------
Documentation on how to use, customize and extend muCommander is available at:
https://github.com/mucommander/mucommander/wiki