Logo Search packages:      
Sourcecode: ranger version File versions  Download package


# Copyright (C) 2009, 2010  Roman Zimbelmann <romanz@lavabit.com>
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# GNU General Public License for more details.
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.

2. Running Files

2.1. How to run files
2.2. The "open_with" command
2.2. Programs
2.4. Modes
2.5. Flags

2.1. How to run files

While highlighting a file, press the "l" key to fire up the automatic
filetype detection mechanism and attempt to start the file.

      l     run the selection
      r     open the console with ":open_with"

Note: The selection means, if there are marked files in this directory,
use them.  Otherwise use the file under the cursor.

2.2. The "open_with" command

If the automatic filetype detection fails or starts the file in a wrong
way, you can press "r" to manually tell ranger how to run it.

The programs and modes can be defined in the apps.py, giving you a
high level interface for running files.

Syntax: :open_with <program> <flags> <mode>
You can leave out parameters or change the order.

Open this file with vim:
      :open_with vim
Run this file like with "./file":
      :open_with self
Open this file as usual but pipe the output to "less"
      :open_with p
Open this file with mplayer with the "detached" flag:
      :open_with mplayer d
Open this file with totem in mode 1, will not detach the process (flag D)
but discard the output (flag s).
      :open_with totem 1 Ds

The parameters <program>, <flags> and <mode> are explained in the
following paragraphs

2.3. Programs

Programs have to be defined in ranger/defaults/apps.py.  Each function
in the class CustomApplications which starts with "app_" can be used
as a program in the "open_with" command.

You're encouraged to add your own program definitions to the list.  Refer to
the existing examples in the apps.py, it should be easy to adapt it for your

2.4. Modes

Sometimes there are multiple variants to open a file.  For example, ranger
gives you 2 ways of opening a video (by default):

      0     windowed
      1     fullscreen

By specifying a mode, you can select one of those.  The "l" key will
start a file in mode 0. "4l" will start the file in mode 4 etc.
You can specify a mode in the "open_with" command by simply adding
the number.  Eg: ":open_with mplayer 1" or ":open_with 1"

For a list of all programs and modes, see ranger/defaults/apps.py

2.5. Flags

Flags give you a way to modify the behaviour of the spawned process.

      s     Silent mode.  Output will be discarded.
      d     Detach the process.  (Run in background)
      p     Redirect output to the pager
      w     Wait for an enter-press when the process is done

For example, ":open_with p" will pipe the output of that process into
the pager.

An uppercase flag has the opposite effect.  If a program will be detached by
default, use ":open_with D" to not detach it.

Note: Some combinations don't make sense, eg: "vim d" would open the file in
vim and detach it.  Since vim is a console application, you loose grip
of that process when you detach it.  It's up to you to do such sanity checks.

# vim:tw=78:sw=4:sts=8:ts=8:ft=help

Generated by  Doxygen 1.6.0   Back to index