This log documents changes between stable versions. # 2019-12-31: version 1.9.3 * Added Comic cbz/cbr previews * Added DjVu previews * Added Font previews * Added Wayland support to rifle * Added `imv` to rifle * Added `paste_ext` command with new name collision behavior * Added a `size_in_bytes` setting * Added a new `%any_path` macro to simplify use of bookmarks in commands * Added a new image previewing method using `ueberzug` * Added archive previews * Added filters for uniqueness and duplicates by hash to `filter_stack` * Added generic openers to rifle, `xdg-open` for example * Added line modes with human readable size information * Added loading of plugins from local configuration directory * Added previews for 3d models using `openscad` * Added previews of MS Office documents * Added scrolling in preview * Added trash functionality to ranger, as alternative to deleting files * Added zathura to rifle * Changed `c/p/tunmap` to `unc/p/tmap` respectively, fixing them in the process * Changed argument order for `tag_toggle` * Fixed `chmod` behavior with `000` quantifier * Fixed a crash involving `Ctrl+space` * Fixed behavior of statusbar when resizing terminal window * Fixed busyloop when ranger's STDIN was closed * Fixed drawing of borders in st * Fixed handling of macros for `chain` * Fixed unicode decoding errors for previews * Improved VCS integration by truncating long commit messages * Improved `bulkrename` behavior when moving files to a non-existing directory * Improved `bulkrename`'s handling of files with utf-16 surrogates in the name * Improved behavior of `rename_append` for directories * Improved configurability of syntax highlighting previews * Improved coverage of unofficial MIME types, mostly audio formats * Improved documentation of `multipane` viewmode * Improved documentation of optional dependencies * Improved documentation on `copymap` * Improved documentation on `tab_shift` * Improved documentation on `w3m_offset` * Improved example shell scripts * Improved extensibility of image previewing methods using a registry * Improved fuzzy tab completion * Improved guessing of file encoding * Improved handling of configuration and cache directories when using `--clean` * Improved handling of invalid mtimes (Relevant for fuse mounts) * Improved logging of file deletion * Improved testing and CI setup * Improved updating of tmux/screen window names * Improved updating of window titles * Improved validation of bookmarks * Improved w3m preview method for terminals that aren't quite compatible # 2018-09-09: version 1.9.2 * Added a `hint_collapse_threshold` setting * Added a `traverse_backwards` command analogous to `traverse` * Added a command to shift tabs * Added a normal mode mapping to quickly enter the console and scroll through the history `C-p` * Added a section to `scope.sh` for image previews of archives * Added an avfs plugin * Added an option to the move command to enable launching the selected file instead of the marked files * Added filtering functionality inspired by dired's filter stack, `.n, .| ...` * Added image preview method for Kitty * Added option to disable the display of free space for high latency situations * Added section to `scope.sh` for pdf previews with mutool * Added several emacs/readline-inspired keybindings, `C-g` for `ESC`, `alt-f/b` * Added systemwide `rc.conf` and `commands.py` in `/etc/ranger` * Added the `%any_path` macro to allow bookmarks to be used with commands that need a path and are unaware of bookmarks * Added versioning logic to include extra info in unreleased versions * Change tab saving to save all tabs, not just the active tab * Changed `draw_borders` setting to enable drawing only borders or seperators * Changed behavior of positional arguments to the ranger command, if you specify a path to a file ranger will open with that file selected * Changed the `tilde_in_titlebar` setting to influence the window titlebar too * Changed the default colorscheme to work properly in terminals that don't equate bold and bright * Fixed StopIteration errors * Fixed embedded null errors * Fixed issues reported by coverity scan * Fixed running ranger as root on Mac OS * Fixed unicode issue for python2 * Fixed w3m preview issues with black stripes * Improved PEP8 adherence * Improved VCS symbols * Improved `--cmd` functionality * Improved file encoding detection by using chardet if it's available * Rifle's flag t should now work with more terminals than xterm and urxvt * Update colorscheme documentation # 2018-02-22: version 1.9.1 * Fixed the rifle config backwards compatibility (regression in 1.9.0) * Fixed the POSIX compatibility of `Makefile` * Fixed `--choosefile`, `--choosefiles` and `--choosedir` so they work with the process substitution (`>(...)` in Bash) * Changed the default `gt` binding to `gp` due to a conflict * Changed the help message for `--choosefile`, `--choosefiles` and `--choosedir` to avoid confusion * Changed the behavior of `:reset` to reload the tags too * Added `geeqie` to the default `rifle.conf` # 2018-01-25: version 1.9.0 * Fixed memory leak in w3m image preview * Fixed `Q` binding, map it to `quitall` instead of `quit!` * Fixed `gR` binding * Fixed custom linemode not being applied to files * Fixed w3m image display invocation on OpenBSD * Fixed broken pager after changing view mode with `~` * Added reset of rifle.conf when pressing `` * Added image-based PDF previews to `scope.sh` (disabled by default) * Added terminology-based image previews * Added check for `$VISUAL` environment variable * Added setting `iterm2_font_height` and `iterm2_font_width` * Renamed setting `cd_tab_smart` to `cd_tab_fuzzy` * Changed command for mercurial integration from `hg` to `chg` # 2017-11-19: version 1.9.0b6 * Fixed crash when parsing corrupted history file * Fixed tab completion with `cd -r ...` * Fixed crash when previewing files encoded in little-endian UTF-16 * Fixed flicker in previewing symlinked images * Fixed detection of location of scope.sh * Fixed crash when running ranger from the directory containing its package * Fixed cursor position after moving half a page down and back up * Fixed handling of lines that are too long for the console * Added `` binding to `:rename_append` * Avoid dereferencing symlinked directory when starting ranger in one * Added support for `file://` URIs as path arguments * Added setting `save_tabs_on_exit` * Added setting `cd_tab_case`, sets case sensitivity of `:cd` tab completion * Added setting `cd_tab_smart`, allows fuzzy tab completion with `:cd`, for example, `:cd /u/lo/b` expands to `:cd /usr/local/bin` * Added setting `global_inode_type_filter` to show only directories when running ranger with the new option `--show-only-dirs` * Added setting `save_backtick_bookmark`, e.g. for easier syncing of bookmarks * Added setting `one_indexed` to start counting line numbers from 1 * Added rifle.conf entries to list/extract archives without atool * Added `:yank` command for simplified definitions of `yn`, `yd` & `yp` * Added `:narrow` command, which filters selected files * Added setting `freeze_files`, bound to `F` key, to avoid reloading files * Changed `:shell -p ...` to display stderr in pager # 2017-02-19: version 1.9.0b5 * Fixed width calculation of multibyte characters in preview * Fixed crash in iTerm2 preview with python 3.5 # 2017-02-10: version 1.9.0b1 * Fixed crash when using `Mi` on files without reading permissions * Fixed natural sorting (`11.jpg` < `100.jpg`) * Fixed loss of precision in timestamps when copying * Fixed smart case matching in `:travel` * Fixed automatically disabling `preview_script` when running as root * Fixed crash on sshfs disconnect * Fixed crash on missing `~/.config/ranger/history` * Fixed crash when path not accessible during start-up * Fixed automatic tmux title * Fixed urxvt image previewing when running tmux * Fixed macro expansion in aliased commands * Fixed `hidden_filter` option when combined with `:flat` * Fixed various other crashes * Fixed error message that occasionally pops up when changing settings * Introduced extensive linting to ensure code quality * Added continuous integration. Patches now require `make test` to pass. * Added handling of arguments in "$PAGER" environment variable * Added quote parsing for `:setlocal path=...` * Added `ys` to copy the selection to clipboard * Added setting `hostname_in_titlebar` * Added setting `wrap_scroll` to wrap cursor around when scrolling * Added example plugin `plugin_fasd_add.py` * Added command `jump_non` to jump to the first non-directory file * Added additional arguments to the command `:rename_append` * Added key binding 'zz' as an alternative to 'zf' * Added option `-c` to the `rifle` file opener command * Added support for `$XDG_DATA_HOME` * Avoid exiting ranger while copying. Use `:quit!` to quit while copying. * Improved scope.sh (better performance & readability) * Improved logs handling by migrating to the python standard logging library (PR #725) * Changed `ranger --choosefiles` to return all selected files in all paths * Changed interpretation of commands: treat tabs as argument separators * Changed `` to open new tab in current directory rather than `$HOME` * Changed `:quit!` to only close 1 tab. Use `:quitall` to close all tabs. * Removed backward compatibility for `options.py`, predecessor of `rc.conf` * Automatically update bookmarks+tags when renaming them via ranger # 2017-01-08: version 1.8.1 * Fixed `:scout` break due to incompatible change in python 3.6 # 2016-12-24: version 1.8.0 * scope.sh is now needed for the now fully scriptable image previews * Overhaul of version control system integration, now with threads * Fixed ranger not finding the location of w3mimgdisplay in most cases * Fixed many minor bugs * Added midnight-commander like multipane view, toggleable with `~` key. It displays the current directory of all the open tabs next to each other. * Added autodetect for 256 color support in scope.sh source code preview * Added macro `%confdir` that expands to `~/.config/ranger` by default * Added possibility to toggle/cycle through options with `set !` * Added `Mm`/`Ms` key to enable the linemode showing modification time * Added `yt`/`dt` keys to toggle whether file is in copy/cut buffer * Added `line_numbers` setting showing absolute/relative line numbers * Added `Alt-Left` and `Alt-Right` key bindings to move by words in console * Added previews for libreoffice files with `odt2txt` * Added `preview_images_method=urxvt` option for previewing images by changing the urxvt background (requires urxvt compiled with pixbuf support) * Added `clear_filters_on_dir_change` option * Added Travis-CI integration * Changed `zi` key to toggle `preview_images` option * Improved PEP8 compliance * Improved documentation * Improved UI by separating file path in titlebar with a space from the username/hostname for quick copy&pasting by shift+double-clicking on it. # 2015-10-04: version 1.7.2 * Fixed file name arguments passed to `sxiv` and `feh` when using `:flat` * Fixed removal of empty directories when using `:rename` * Fixed free disk space display on Mac OS X * Fixed `examples/vim_file_chooser` to work with gvim too * Fixed some other rare crashes and bugs * Fixed downward mouse wheel scrolling * Fixed warning about regex splits being drawn in titlebar since python3.5 * Really fixed `S` key binding not working when SHELL=fish * Improved `doc/cheatsheet.svg` * Added some entries to rifle.conf * Added key bindings `pO` and `pP` which work like `po` and `pp` but queue the operation in a first-in-first-out order. # 2015-05-04: version 1.7.1 * Added `doc/cheatsheet.svg` * Added `examples/rc_emacs.conf`, a config file adding emacs-like key bindings * Added `env` keyword in rifle.conf * Fixed `:bulkrename` command in python3 * Fixed `S` key binding not working when SHELL=fish # 2015-04-13: version 1.7.0 * The default editor is now `vim` instead of `nano` * Added automatic updates of tags when a file is renamed from within ranger * Added `preview_images_method` which can be set to `iterm2` to use native iTerm2 image previews * Added `:rename_append` command to rename files without the file extension * Added `:linemode` command to change the way the files are displayed Try this out by pressing M followed by one of the suggested keys. New linemodes can be added with `ranger.api.register_linemode()`. * Added `:filter_inode_type` command to only show directories, files or links * Added `:meta` command for managing custom file metadata * Added `:flat` command for displaying subdirectories * Added `solarized` colorscheme * Added generic ability to use scope.sh for image previews * Added video previews in scope.sh * Added option `sort_unicode` to sort according to unicode, not ASCII * `:mkdir` can now create multiple directory levels (like `mkdir -p`) * `:help` (key binding `?`) is now interactive * `:find` (key binding `/`) is now case insensitive by default * `ranger --copy-config=all` now copies a short sample commands.py rather than the full one, so that you can update ranger without having broken commands. The full commands.py is still copied to `~/.config/ranger/commands_full.py`. * Fixed broken copying of symlinks # 2013-05-24: Version 1.6.1 * Added support for version control systems, see: http://lists.nongnu.org/archive/html/ranger-users/2013-03/msg00007.html * Added :scout command as a unified backend to :find, :search, etc * Added `open_all_images` setting to remove the need for external scripts to handle opening of all images in a directory at once. * Now previewing with `i` uses the whole available width. # 2013-02-22: Version 1.6.0 * Overhauled all config files. Please update them or use the --clean switch * Added `examples/` directory to source code which contains sample programs or plugins that can be used together with ranger * Added progress bars to copying, moving and directory loading processes * Added feature to draw images inside the console using w3mimgdisplay (you need to add `set preview_images true` in rc.conf) * Added a plugin system like in the program `anki`, i.e. place any python file into ~/.config/ranger/plugins/ and it will be imported by ranger * Added a separate file launcher named `rifle` that is configured through rifle.conf and is installed as a standalone program. Using `ranger [filename]` from the shell for opening files is deprecated now, please use `rifle [filename]` instead. * Added `uq` keybinding to undo closed tabs * Added :setlocal command to change settings for specific directories only * Added :travel command to move more quickly to your destination * Added 256 color support for scope.sh * Added a real yes/no prompt for :delete command * Added settings: `confirm_on_delete`, `draw_progress_bar_in_status_bar`, `preview_images`, `status_bar_on_top`, `update_tmux_title` * Added commands: `:mark_tag`, `:unmark_tag` * Added BSD-friendly setsid implementation * Added as-you-type filtering for `:filter` command * Replaced `options.py` file by :set commands in rc.conf * Replaced `apps.py` file with rifle.conf * Improved `r` key to interface with rifle * Rewritten `scope.sh` in POSIX shell * Changed copying/moving code to work without GNU coreutils * Changed key to untag files from `T` to `ut` * Changed the flag `d` (for detached) to `f` (for fork) in program launcher * Changed appearance of keybinding-hints and bookmarks * Changed tabs with 4 spaces in the source code (see PEP 8) * Removed ranger.core.environment class * Removed settings: `colorscheme_overlay`, `draw_bookmark_borders`, `init_function`, `load_default_rc` * Fixed zombie process apocalypse * Fixed `draw_borders=true` in combination with `padding_right=false` # 2012-08-10: Version 1.5.5 * Ensure that detached programs continue to run when ranger is killed # 2012-05-03: Version 1.5.4 * Added exiftool to scope.sh by default * Fixed a crash when entering a directory with a unicode name * Speedup in `ranger.ext.get_executables` # 2012-03-05: Version 1.5.3 * Added --selectfile option that selects a certain file on startup * Added --list-tagged-files option * Added --cmd option to run commands on startup * Added --profile option for additional debug information on exit * Added a visual mode (activate with `V`, deactivate with Esc) * Added a reversed visual mode (activate with `uV`) * Added `$RANGER_LEVEL` environment variable which ranger sets to `1` or higher so programs can know that they were spawned from ranger * Added run flag `r` for running with root privileges (needs sudo) * Added run flag `t` for running in a new terminal (as specified in $TERMCMD) * Added :relink command to change destinations of symlinks * Added `dc` binding for getting the cumulative size of a directory * Added `autoupdate_cumulative_size` option * Added `pht` binding to Paste Hardlinked subTrees (like cp -l) * Improved sorting speed of signals (noticeable when caching many directories) * Improved drawing speed * Fixed unexpected behavior when displaying nonprintable characters * Fixed :bulkrename to work with files starting with a minus sign * Fixed RangerChooser example in man page * Fixed crash when opening images with sxiv/feh by running `ranger ` # 2011-10-23: Version 1.5.2 * Fixed graphical bug that appears in certain cases when drawing characters at the right edge. # 2011-10-23: Version 1.5.1 * Added `fm.select_file(path)` * Added --choosefiles option (like --choosefile, but chooses multiple files) * Fixed --list-unused-keys * Fixed Zombie processes * Fixed handling of filenames with undecodable bytes (unicode surrogates) * Fixed crashes due to incomplete loading of directories * Fixed tab completion of the command `shell` * Fixed `ot` and `oT` keys in rc.conf * Fixed parsing of chained commands (like in the binding `om`) # 2011-10-11: Version 1.5.0 * Full python3.2 compatibility * Added new configuration file `rc.conf` which contains a list of commands that are executed on startup - mainly used for keybindings * Added --list-unused-keys * Added new program handlers to apps.py * Added pop-up window for keychains and bookmarks * Added `load_default_rc` option * Fixed all known unicode issues * Fixed crash when $TERM is unknown to the system * Fixed scrolling in colored preview * Changed the default `column_ratios` to 1/3/4 and sorting method to `natural` * Changed :rename so it doesn't overwrite existing files * Internal actions are now accessible as commands * Replaced unittests by doctests * Replaced integrated help with an extended man page and dynamic lists of keybindings, commands and settings. * Removed `keys.py` configuration file in favor of `rc.conf` * Removed `texas` colorscheme * apps.py: Now able to define programs that only run with Xorg * commands.py: Using parse(self.line) to parse the line is unnecessary now. parse(self.line).rest(n) is now written as self.rest(n). However, parse(self.line).chunk(n) has been renamed to self.arg(n). * commands.py: parse(self.line) + X is now self.firstpart + X * commands.py: New special attribute `resolve_macros` which decides whether strings like %f should be expanded to the name of the current file, etc. * commands.py: New special attribute `escape_macros_for_shell` to toggle whether or not macros should be escaped, so you can use them in other commands than :shell, for example :edit %f * Countless small fixes and improvements # 2011-10-02: Version 1.4.4 * Added keys for chmod (like +ow for `chmod o+w`, etc) * Added `c` flag for running files * Added various key bindings * Added wavpack and webm types to mime.types * Added option `display_tags_in_all_columns` * Added command.cancel method which is called when pressing ESC in console * Added sorting and cycling by ctime and atime * Added custom tags (press "x) * Added bittorrent preview * Fixed blocking when using interactive scripts in scope.sh * Fixed issues with ALT key * Fixed pager crash when trying to read non-readable file * Forbid piping things into ranger * Improved hints # 2011-04-05: Version 1.4.3 * Fixed mimetype checking when invoking ranger with a filename * Fixed loss of bookmarks when disk is full * Minor improvements # 2011-03-05: Version 1.4.2 * Added --choosefile and --choosedir flag * Added use of bookmarks in tab completion of the :cd command * Fixed bug with detached programs and python 3.2 # 2011-01-04: Version 1.4.1 * Fixed crash when preview failed under some circumstances * Fixed graphical bug when pressing i # 2010-12-22: Version 1.4.0 * Added option to use any external scripts for previews (see scope.sh) * Added key: zv to toggle the use of the external script * Added indicator for the used filter (type `zf`) * Added option `padding_right` to remove whitespace if theres no preview * Added command `:search_inc` for incremental search * Added commands `:save_copy_buffer` and `:load_copy_buffer` to share the copied files between ranger instances * Added mimeopen as a fallback if no useful application can be found * Added natural sort, sorts 1foo before 10foo. (type `on`) * Added keys: yp, yd and yb to copy path, dirname or basename to seleciton * Let `open_with` use the selection, not just one file * Run files with right mouse click * Implemented copying via coreutils rather than internal python code * Improved handling of unicode * Some restructuration of the source code # 2010-12-13: Version 1.2.3 * Enable binding to alt-keys * Fixed memory leak in garbage collecting of old, unused directory objects * Fixed python3 incompatibilities * Fixed problems with identifying changes of files * Fixed lazy lookup of some FSObject attributes # 2010-10-10: Version 1.2.2 * Prevent currently used directories from being garbage collected * Disable mouse buttons when console is open * Fixed :cd command: Without arguments, cd's into $HOME * Fixed bug which prevented pydoc to work on some config files * Fixed some bugs in `snow` and `jungle` colorschemes * Several other clean-ups and fixes # 2010-09-16: Version 1.2.1 * Fixed yy/pp bug when yanking multiple directories # 2010-09-13: Version 1.2.0 * !!! Changed the default configuration directory to ~/.config/ranger !!! * Removed `Console Modes`, each old mode is now a simple command * Disabled file previews by default if ranger is used by root * Allow to jump to specific help sections by typing two numbers, e.g. 13? * Added keys: da, dr, ya, yr for adding and removing files from copy buffer * Added keys: gl and gL to resolve links, see 11? * Added key: pL to create a relative symlink * Added % and % macros for the console, see 33? * Fixed ansi codes for colors in the pager * Use the file ~/.mime.types for mime type detection * Several clean-ups and fixes # 2010-07-17: Version 1.1.2 * Fix crash when using scrollwheel to scroll down in some cases * The command `ranger dir1 dir2 ...` opens multiple directories in tabs * Removed pydoc html documentation by default, re-create it with `make doc` * Minor fixes # 2010-06-18: Version 1.1.1 * New install script, `setup.py` * New flag for running programs: `w` (waits for enter press) * Minor fixes # 2010-06-09: Version 1.1.0 * Added a man page * Tab support * Improved directory loading performance * Commands are definable in ~/.ranger/commands.py * Case insensitive sorting (type zs) * Better UTF support * Possibility to turn off previews (zp and zP) * Changing options with :set (e.g. `:set column_ratios=1,2,3,4`) * Ask for confirmation when using :delete * New invocation flag: --fail-unless-cd * New hotkeys, commands, options. * New syntax for ~/.ranger/keys.py * Several user contributions * And tons of general improvements