_____ _ _____ _ _| |___ _____ _____ ___ ___ _| |___ ___ | | | | --| . | | | .'| | . | -_| _| |_|_|_|___|_____|___|_|_|_|_|_|_|__,|_|_|___|___|_| ------------------ muCommander v1.3.0 ------------------ 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: https://www.mucommander.com Requirements ------------ A Java Runtime Environment (JRE) 11 or later is required to run muCommander. Java 17 is recommended, you can download it from https://adoptium.net/temurin. 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 v1.2.0 ? ----------------------- New features: - Replace-all functionality for the internal text editor. - Additional operations for the internal binary editor: undo/redo, search/replace. - Additional search options for the internal text viewer/editor: case-sensitivity, whole-words, regular expressions, forward/backward. - Browsing and extracting multi-volume RAR 5+ files. - Dock/TaskBar icon shows the number of active jobs and their progress. - Open With menu includes compatible apps on macOS. - Support for Android Debug Bridge (adb). - Google Drive: present files shared with the authorized user in the 'Shared with me' folder. - Google Drive: present trashed files in the 'Trash' folder. - Google Drive: documents, spreadsheets and presentations are shown and can be downloaded in their corresponding OpenDocument format (odt, ods, and odp). - The terminal's keyboard shortcuts can be configured using the Shortcut Preferences dialog - Browsing and extracting multi-volume 7z files. Improvements: - When sorting a file table by filenames, the sort operation performs a locale-sensitive String comparison. - When opening a result of a file search with text search using the internal viewer/editor, the caret is set on the first occurrence of the searched text. - The action categories that are displayed in the shortcuts preferences tab are sorted by their name. - The row-filtering in the shortcuts preferences tab now matches the specified input also against the tooltip of the row (the action's description). - Theme preferences for Shell renamed to Terminal and now both the Terminal and Run Command dialog use configured colors and font. - Google Drive: file queries can return up to 1000 files instead of up to 100 files. - Set the 'File version' property of the 'mucommander.exe' file to the application version. - Menlo font is added as one of the default fonts of the Terminal for all themes (also native ones). Bug fixes: - Fixed connection to SFTP servers using a private key. - The terminal accepts input that wasn't accepted before from German keyboard when disabling the setting 'Use Option as Meta key in Terminal'. - The terminal displays diacritics in a form of decomposed characters properly. - When source files cannot be opened with code-folding using the internal text viewer/editor, it falls back to opening them without code-folding. Known issues: - Some translations may not be up-to-date. - SMB support may not work properly on non-multi-language JRE. - 'Copy files to clipboard' not working with some applications (files are not pasted). - 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 - 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. - macOS: issues with browsing Documents/Desktop/Downloads 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. - macOS: muCommander may not start on older versions of macOS due to incompatibility of the bundled JRE. - macOS: "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. - macOS: some keyboard shortcuts may conflict with global system shortcuts. 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 https://github.com/mwiede/jsch . - the 7-Zip-JBinding library released under the GNU LGPL. 7-Zip-JBinding can be found at http://sevenzipjbind.sourceforge.net . - the jCIFS library released under the GNU LGPL. jCIFS can be found at http://jcifs.samba.org . - JediTerm library released under dual GNU LGPL and Apache License. JediTerm can be found at https://github.com/JetBrains/jediterm . - 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 RSyntaxTextArea library under the terms of BSD 3-Clause "New" or "Revised" License RSyntaxTextArea can be found at https://bobbylight.github.io/RSyntaxTextArea . - 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 https://github.com/pcorless/icepdf . - the Unix4j library released under the MIT License. Unix4j can be found at http://unix4j.org/ . - the FlatLaf library released under the Apache License. FlatLaf can be found at https://www.formdev.com/flatlaf . - 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 - Piotr Skowronek - 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