ranger - mirror of ranger - a simple, vim-like file manager

	Commit message (Expand)	Author	Age	Files	Lines
*	add more detailed implementation note	NRK	2021-09-19	1	-0/+14
*	add an implementation note	NRK	2021-09-19	1	-0/+4
*	-print explicitly for posix compliance	NRK	2021-09-19	1	-1/+1
*	use grep -iE instead of -iname	NRK	2021-09-18	1	-3/+2
*	switch to -iname	NRK	2021-09-13	1	-2/+2
*	use more posix complaint flags	NRK	2021-09-13	1	-2/+4
*	cleanups	NRK	2021-09-13	1	-22/+16
*	rework the script	NRK	2021-09-13	1	-3/+6
*	sxiv-rifle: only list extensions	NRK	2021-09-08	1	-1/+1
*	sxiv-rifle: add tiff support	NRK	2021-08-27	1	-2/+2
*	change order of bmp	N-R-K	2021-08-27	1	-2/+2
*	sxiv-rifle: handle unresolved `~`	NRK	2021-08-27	1	-0/+1
*	change func name to is_img	N-R-K	2021-08-27	1	-2/+2
*	sxiv-rifle: don't grep non img extension files	NRK	2021-08-27	1	-1/+8
*	sxiv-rifle: use parameter expansion instead of cut	NRK	2021-08-27	1	-2/+2
*	sxiv-rifle: don't grep if $target is not a file	NRK	2021-08-27	1	-1/+1
*	fix edge case when file is in root	NRK	2021-08-15	1	-1/+1
*	rifle_sxiv: add webp to listfiles()	NRK	2021-08-09	1	-1/+1
*	rifle_sxiv: performance improvement	NRK	2021-08-09	1	-17/+9
*	shell_automatic_cd: Fix function name in bind command	toonn	2021-02-19	1	-2/+2
*	Update the docs to reflect changes to code	Zoran Plesivcak	2020-11-08	1	-2/+2
*	Merge branch 'dmitmel-examples-bash-automatic-cd'	toonn	2019-12-31	4	-28/+33
\|\
\| *	Added shellcheck directives for specifying shell	Dmytro Meleshko	2019-11-06	2	-0/+4
\| *	Added a notice about sourcing examples/shell_subshell_notice.sh as well	Dmytro Meleshko	2019-11-06	1	-1/+2
\| *	Added mention about sourcing examples/shell_automatic_cd.sh from shell config	Dmytro Meleshko	2019-11-06	1	-1/+2
\| *	Updated comments about compatibility with ranger versions	Dmytro Meleshko	2019-11-06	2	-2/+2
\| *	Removed shebangs	Dmytro Meleshko	2019-11-06	2	-4/+0
\| *	Renamed script files to not mention Bash	Dmytro Meleshko	2019-11-02	2	-0/+0
\| *	Added shebangs and removed notices specifically about Bash	Dmytro Meleshko	2019-11-02	2	-4/+8
\| *	Apply requested changes to ranger.py and enforce full POSIX compliance	Dmytro Meleshko	2019-10-28	1	-4/+3
\| *	Removed replaced $(<...) with cat	Dmytro Meleshko	2019-10-28	1	-1/+1
\| *	Added comparison with $PWD back	Dmytro Meleshko	2019-10-28	1	-1/+1
\| *	Replaced `[[` with POSIX-compatible `[`	Dmytro Meleshko	2019-10-28	1	-1/+1
\| *	Added pattern for mktemp back	Dmytro Meleshko	2019-10-28	1	-1/+1
\| *	Removed unnecessary arguments for mktemp in examples/bash_automatic_cd.sh	Dmytro Meleshko	2019-10-27	1	-1/+1
\| *	Refactored examples/bash_automatic_cd.sh	Dmytro Meleshko	2019-10-27	1	-7/+7
* \|	Merge branch 'siikamiika-feat-update-icon-title'	toonn	2019-12-22	1	-2/+3
\|\ \
\| * \|	Merge the title settings	toonn	2019-12-22	1	-5/+3
\| * \|	Merge branch 'master' into feat-update-icon-title	siikamiika	2019-12-09	1	-0/+8
\| \|\\|
\| * \|	add update_icon_title option	siikamiika	2019-07-25	1	-0/+3
* \| \|	use function, cleanup file, proper repaint	Mathis Chenuet	2019-11-08	1	-2/+8
* \| \|	add doc and binding	Mathis Chenuet	2019-11-03	1	-0/+10
* \| \|	port automatic_cd to fish	Mathis Chenuet	2019-11-03	1	-0/+5
\| \|/ \|/\|
* \|	Add a configurable VCS max message length	Wojciech Siewierski	2019-10-01	1	-0/+3
* \|	Drop truth values; rename warning setting	Toon Nolten	2019-08-18	1	-1/+1
* \|	Warn when nesting ranger	toonn	2019-08-03	1	-0/+5
\|/
*	Merge branch 'master' into patch-4	Nathaniel	2018-09-05	1	-3/+1
\|\
\| *	Remove hard code of ranger path	Mark Blakeney	2018-08-19	1	-3/+1
* \|	Remove extra pipe in subprocess call, rename plugin and add original	natemaia	2018-09-05	2	-47/+89
* \|	2 lines around function definition	Nathaniel	2018-07-07	1	-0/+1

Ranger v.1.0.4 ============== Ranger A keeper, guardian, or soldier who ranges over a region to protect the area or enforce the law. This is the filemanager Chuck Norris the Texas Ranger would use if he had a computer with a unix-like operating system. (He doesn't trust computers though and prefers to do the calculations himself.) After all, as a professional ranger, he needs a broad overview of his territory, and the multi-column display of ranger provides just that, rather than restricting you to the current directory only. You can preview the content of the selected file or directory, copy or move files around with the VIM-like commands dd and yy, execute predefined applications when opening a file, etc... Everything is fully customizable and written in Python (2.6 and 3.1 compatible) using curses for the text-based user interface. About ----- * Author: Roman Zimbelmann * Email: romanz@lavabit.com * Git repo: http://git.savannah.gnu.org/cgit/ranger.git * Version: 1.0.4 Features -------- * Multi-column display * Preview of the selected file/directory * Common file operations (create/chmod/copy/delete/...) * Quickly find files or text inside files * VIM-like console and hotkeys * Open files in external programs * Mouse support * Change the directory of your shell after exiting ranger * Bookmarks Dependencies ------------ * A Unix-like Operating System * Python 2.6 or 3.1 * Python curses module (often but not always included with Python) Bugs and Feature Requests ------------------------- Report bugs and feature requests on savannah: https://savannah.nongnu.org/bugs/?func=additem&group=ranger Alternatively you can send an email to romanz@lavabit.com. Please include as much relevant information as possible. Using ranger with the --debug option will abort the program and print tracebacks rather than a red message in the statusbar. If this applies to you, please include such a traceback in your report. Getting Started --------------- If you just want to check out ranger without installing it, type ./ranger.py --clean in the top directory of ranger. By using the --clean switch, it will leave no trace on your system whatsoever. To properly install it, follow the instructions in the INSTALL file, then type: ranger You should see 4 columns. The third is the directory where you are at the moment. To the left, there are the directories above the current working directory, and the column on the right is a preview of the selected file/directory. Now use the arrow keys to navigate, press enter to open a file. A list of commands with short descriptions can be viewed by pressing "?" inside the program and following the instructions. The file ranger/defaults/keys.py contains all key combinations, so that's another place you may want to check out. More extensive documentation will be written when enough users ask me to :) Opening Files with Ranger ------------------------- If you use the same applications like me, you'll be able to open files by pressing the right arrow key. If not, you will have to specify them in ranger/defaults/apps.py. It's explained in the docstrings how exactly to do that. Once you've set up your applications, you can also use ranger to open files from the shell: ranger blabla.pdf Customizing Ranger ------------------ The file ranger/defaults/options.py contains most of the options. apps.py defines how files are run, keys.py defines keybindings. The files in ranger/defaults/ can be copied into ~/.ranger/ for per-user modifications. Colorschemes can be placed in ~/.ranger/colorschemes. The configuration files should be self-explanatory. If you need more information, check out the source code. Also, see the file HACKING for more detailed instructions on modifying the program.