about summary refs log tree commit diff stats
Commit message (Collapse)AuthorAgeFilesLines
* Merge branch '#551' of github.com:PMaynard/profanity into #551Pete2015-06-011-1/+1
|\
| * Extra underlinePete Maynard2015-06-011-1/+1
| |
* | Added Theme UI option for window auto tidyPete2015-06-011-0/+1
|/
* Refactored 'ui_tidy_wins()' to return bool and not output text, Corrected ↵Pete2015-06-015-14/+14
| | | | underline, removed call to function 'wins_resize_all()'.
* Added winstidy to test stubPete Maynard2015-05-311-0/+1
|
* Added window auto tidy.Pete2015-05-297-2/+42
|
* Added jid to OTR errors in consoleJames Booth2015-05-251-1/+1
|
* Added uuid dependency to install-all.sh, opensuse, fedora and cygwinJames Booth2015-05-191-4/+4
|
* Merge pull request #547 from PMaynard/update-install-script-for-uuid-devJames Booth2015-05-191-1/+1
|\ | | | | Udpate installer.sh to include uuid-dev
| * Udpate installer.sh for Debain to unclude uuid-devPete Maynard2015-05-181-1/+1
|/
* Merge remote-tracking branch 'adament/carbons'James Booth2015-05-171-14/+12
|\
| * allow enabling / disabling carbons without being connected.Adam Ehlers Nyholm Thomsen2015-05-171-14/+12
|/
* Tidy ui_room_messageJames Booth2015-05-101-60/+62
|
* Moved logic to notify_messageJames Booth2015-05-104-37/+21
|
* Added cl_ev_presence_sendJames Booth2015-05-075-8/+18
|
* Renamed presence_update -> presence_sendJames Booth2015-05-077-22/+17
|
* Tidied _roster_result_handlerJames Booth2015-05-071-32/+30
|
* Added ui_contact_onlineJames Booth2015-05-076-95/+64
|
* Optimised occupant comparisons, create utf8 collate key onceJames Booth2015-05-072-9/+7
|
* Optimised contact comparisons, create utf8 collate key onceJames Booth2015-05-073-13/+30
|
* Set ui nonblocking on presence updatesJames Booth2015-05-061-0/+6
| | | | Speeds up joining rooms, and connecting.
* Tidied form field autocompletersJames Booth2015-05-051-22/+26
|
* Use null check convention in roster_list.cJames Booth2015-05-041-15/+15
|
* Use null check convention in resource.cJames Booth2015-05-041-2/+2
|
* Use null check convention in profanity.cJames Booth2015-05-041-2/+2
|
* Use null check convention in log.cJames Booth2015-05-041-8/+8
|
* Use null check convention in jid.cJames Booth2015-05-041-5/+5
|
* Use null check convention in contact.cJames Booth2015-05-041-14/+14
|
* Use null check convention in common.cJames Booth2015-05-041-10/+10
|
* Use null check convention in chat_session.cJames Booth2015-05-041-2/+2
|
* Use null check convention in stanza.cJames Booth2015-05-041-32/+32
|
* Use null check convention in roster.cJames Booth2015-05-041-11/+11
|
* Use null check convention in presence.cJames Booth2015-05-041-21/+21
|
* Use null check convention in iq.cJames Booth2015-05-041-48/+48
|
* Use null check convention in form.cJames Booth2015-05-041-1/+1
|
* Use null check convention in connection.cJames Booth2015-05-041-12/+12
|
* Use null check convention in capabilities.cJames Booth2015-05-041-15/+15
|
* Use null check convention in bookmark.cJames Booth2015-05-041-11/+11
|
* Use null check convention in windows.cJames Booth2015-05-041-18/+18
|
* Use null check convention in window.cJames Booth2015-05-041-38/+38
|
* Use null check convention in titlebar.cJames Booth2015-05-041-3/+3
|
* Use null check convention in statusbar.cJames Booth2015-05-041-7/+7
|
* Use null check convention in notifier.cJames Booth2015-05-041-4/+4
|
* Use null check convention in core.cJames Booth2015-05-041-62/+62
|
* Use null check convention in console.cJames Booth2015-05-041-80/+80
|
* Use null check convention in tinyurl.cJames Booth2015-05-041-1/+1
|
* Use null check convention in parser.cJames Booth2015-05-041-4/+4
|
* Use null check convention in otrlibv4.cJames Booth2015-05-041-1/+1
|
* Use null check convention in otrlibv3.cJames Booth2015-05-041-3/+3
|
* Use null check convention in otr.cJames Booth2015-05-041-9/+9
|
ME.md?h=v1.9.1&id=ded8e6756779c52b5d63ae92e78affe4812544ca'>^
240394a4 ^

03ed2a43 ^


2c8cb95f ^
03ed2a43 ^
240394a4 ^

e5fb3d74 ^
240394a4 ^

03ed2a43 ^

7dc8fef8 ^


03ed2a43 ^
d9b5426e ^
78edc1ed ^
d9b5426e ^
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

            
 
                                                                                                             
 
                                                                     
                                                                              
                                                                            
                                            
 
                                                                                                       
 
                                                                             






                                                                                   
                                                                           
                                                          
 
                                                                             
               

 

     
                                 
                                                   

                                                            
                                                      
                                                 
 
 

            





                                                              

        
                                                  
                      

                                                       
                                 
                              
                                                                       
                                                         
                                

 

            
                                                      
                                        
                             

         
 



                                                                     
 
                                                       
 

                                                             
                                                           




                                                                       



          
                                                                   
                                                                                 

                           


                 

                           


                                                                  
 
                                                                                 

                        
 

               

                                                                                         


                                                                           
                                                                               
                                                                         
                                                                 
                                               
ranger 1.9.0
============

[![Build Status](https://travis-ci.org/ranger/ranger.svg?branch=master)](https://travis-ci.org/ranger/ranger)

ranger is a console file manager with VI key bindings.  It provides a
minimalistic and nice curses interface with a view on the directory hierarchy.
It ships with `rifle`, a file launcher that is good at automatically finding
out which program to use for what file type.

![screenshot](https://raw.githubusercontent.com/ranger/ranger-assets/master/screenshots/screenshot.png)

This file describes ranger and how to get it to run.  For instructions on the
usage, please read the man page.  See `HACKING.md` for development specific
information.

For configuration, check the files in `ranger/config/` or copy the
default config to `~/.config/ranger` with `ranger --copy-config`.

The `examples/` directory contains several scripts and plugins that demonstrate how
ranger can be extended or combined with other programs.  These files can be
found in the git repository or in `/usr/share/doc/ranger`.

A note to packagers: Versions meant for packaging are listed in the changelog
on the website.


About
-----
* Authors:     see `AUTHORS` file
* License:     GNU General Public License Version 3
* Website:     http://ranger.nongnu.org/
* Download:    http://ranger.nongnu.org/ranger-stable.tar.gz
* Bug reports: https://github.com/ranger/ranger/issues
* git clone    http://git.sv.gnu.org/r/ranger.git


Design Goals
------------
* An easily maintainable file manager in a high level language
* A quick way to switch directories and browse the file system
* Keep it small but useful, do one thing and do it well
* Console based, with smooth integration into the unix shell


Features
--------
* UTF-8 Support  (if your python copy supports it)
* Multi-column display
* Preview of the selected file/directory
* Common file operations (create/chmod/copy/delete/...)
* Renaming multiple files at once
* VIM-like console and hotkeys
* Automatically determine file types and run them with correct programs
* Change the directory of your shell after exiting ranger
* Tabs, bookmarks, mouse support


Dependencies
------------
* Python (`>=2.6` or `>=3.1`) with the `curses` module
  and (optionally) wide-unicode support.
* A pager (`less` by default)

Optional:

* The `file` program for determining file types
* The python module `chardet`, in case of encoding detection problems
* `sudo` to use the "run as root"-feature
* `w3m` for the `w3mimgdisplay` program to preview images

Optional, for enhanced file previews (with `scope.sh`):

* `img2txt` (from `caca-utils`) for ASCII-art image previews
* `highlight` or `pygmentize` for syntax highlighting of code
* `atool`, `bsdtar` and/or `unrar` for previews of archives
* `lynx`, `w3m` or `elinks` for previews of html pages
* `pdftotext` for pdf previews
* `transmission-show` for viewing bit-torrent information
* `mediainfo` or `exiftool` for viewing information about media files
* `odt2txt` for OpenDocument text files (`odt`, `ods`, `odp` and `sxw`)


Installing
----------
Use the package manager of your operating system to install ranger.
Note that ranger can be started without installing by simply running `ranger.py`.

To install ranger manually:
```
sudo make install
```

This translates roughly to:
```
sudo python setup.py install --optimize=1 --record=install_log.txt
```

This also saves a list of all installed files to `install_log.txt`, which you can
use to uninstall ranger.


Getting Started
---------------
After starting ranger, you can use the Arrow Keys or `h` `j` `k` `l` to navigate, `Enter`
to open a file or type `Q` to quit.  The third column shows a preview of the
current file.  The second is the main column and the first shows the parent
directory.

Ranger can automatically copy default configuration files to `~/.config/ranger`
if you run it with the switch `--copy-config=( rc | scope | ... | all )`.
See `ranger --help` for a description of that switch.  Also check
`ranger/config/` for the default configuration.