====== Installation ======
===== Main program =====
You need to install ranger through your package manager or via the source

===== Dependencies =====
You can install the following software:

  * python-chardet: in case of encoding detection problems
  * sudo: to use the "run as root"-feature
  * libcaca: for ASCII-art image previews
  * highlight: for syntax highlighting of code
  * atool: for previews of archives
  * w3m: for previews of images and html pages
  * lynx: for previews of html pages
  * elinks: for previews of html pages
  * poppler: for pdf previews
  * transmission-cli: for viewing bittorrent information
  * mediainfo: for viewing information about media files
  * perl-image-exiftool: for viewing information about media files

====== Configuration ======
===== First run =====
<code bash>ranger --copy-config=all</code>
Output
<code>creating: /home/warnaud/.config/ranger/rifle.conf
creating: /home/warnaud/.config/ranger/commands.py
creating: /home/warnaud/.config/ranger/commands_full.py
creating: /home/warnaud/.config/ranger/rc.conf
creating: /home/warnaud/.config/ranger/scope.sh

> Please note that configuration files may change as ranger evolves.
  It's completely up to you to keep them up to date.

> To stop ranger from loading both the default and your custom rc.conf,
  please set the environment variable RANGER_LOAD_DEFAULT_RC to FALSE. </code>
We just copied the default configuration files to our home

===== First Setup =====
==== Image display ====
You can display images in the terminal! just add/modify in **~/.config/ranger/rc.conf**:
<code bash>
# Use one of the supported image preview protocols
set preview_images true
</code>
By default it is set with w3m:
<code bash>set preview_images_method w3m</code>
:!: If the images doesn't show up correctly (as for me) please set:
<code bash>
# Draw borders around columns?
set draw_borders true
</code>
==== VCS display ====
<code bash>
# Be aware of version control systems and display information.
set vcs_aware true
</code>
:!: Works with git/mercurial/bzr :!: \\
→ http://lists.nongnu.org/archive/html/ranger-users/2013-03/msg00007.html for a complete explanation
====== CheatSheet ======
Key combination for Ranger:
{{ :cli:cheatsheet.png?nolink |}}

====== References ======
  * [[https://wiki.archlinux.org/index.php/Ranger]]
  * [[http://ranger.nongnu.org/|Main site]] / [[https://github.com/hut/ranger/wiki|Wiki]] / [[http://ranger.nongnu.org/documentation.html|Documentation]]