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
|
# 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
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# 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" prompt
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 "open with" prompt
Note: The selection means, if there are marked files in this directory,
use them. Otherwise use the file under the cursor.
==============================================================================
2.2. open with:
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.
Syntax: open with: <program> <flags> <mode>
Examples:
Open this file with vim:
open with: vim
Run this file like with "./file":
open with: self
Open this file with mplayer with the "detached" flag:
open with: mplayer d
The parameters <program>, <flags> and <mode> are explained in the
following paragraphs
Note: The "open with" console is named QuickOpenConsole in the source code.
==============================================================================
2.3. Programs
Programs have to be defined in ranger/apps.py. Each function
in the class CustomApplications which starts with "app_" can be used
as a program in the "open with" prompt.
You're encouraged to add your own program definitions to the list. Refer to
documentation in ranger/applications.py for more information on this subject.
==============================================================================
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 fullscreen
1 windowed
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" console by simply adding
the number. Eg: "open with: mplayer 1" or "open with: 1"
For a list of all programs and modes, see ranger/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.
p Redirect output to the pager
For example, "open with: p" will pipe the output of that process into
the pager.
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
|