# 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/>.
"""
This is the default ranger configuration file for filetype detection
and application handling.
You can place this file in your ~/.ranger/ directory and it will be used
instead of this one. Though, to minimize your effort when upgrading ranger,
you may want to subclass CustomApplications rather than making a full copy.
This example modifies the behaviour of "feh" and adds a custom media player:
#### start of the ~/.ranger/apps.py example
from ranger.defaults.apps import CustomApplications as DefaultApps
from ranger.api.apps import *
class CustomApplications(DefaultApps):
def app_kaffeine(self, c):
return tup('kaffeine', *c)
def app_feh_fullscreen_by_default(self, c):
return tup('feh', '-F', *c)
def app_default(self, c):
f = c.file #shortcut
if f.video or f.audio:
return self.app_kaffeine(c)
if f.image and c.mode == 0:
return self.app_feh_fullscreen_by_default(c)
return DefaultApps.app_default(self, c)
#### end of the example
"""
from ranger.api.apps import *
from ranger.ext.get_executables import get_executables
# Often a program is just started like this: `programname filename [...]`
# For example: `vim test.py readme.txt`. This can be implemented like:
# @depends_on("programname")
# def app_programname(self, c):
# return tup("programname", *c)
# Instead of creating such a generic function for each program, just add
# its name into this array:
generic_apps = '''
vim fceux elinks wine zsnes javac
'''.split()
# Sometimes you don't want the program to block ranger's terminal. You could
# add this line before the return statement:
# c.flags += "d" # "d" for "detached"
# Write the name of those programs into this array:
detached_apps = '''
opera firefox apvlv evince zathura gimp mirage eog
'''.split()
@generic(simple=generic_apps, detached=detached_apps)
class CustomApplications(Applications):
def app_default(self, c):
"""How to determine the default application?"""
f = c.file
if f.basename.lower() == 'makefile':
return self.app_make(c)
if f.extension is not None:
if f.extension in ('pdf', ):
c.flags += 'd'
return self.either(c, 'evince', 'zathura', 'apvlv')
if f.extension in ('xml', ):
return self.app_editor(c)
if f.extension in ('html', 'htm', 'xhtml'):
return self.either(c, 'firefox', 'opera', 'elinks')
if f.extension in ('swf', ):
return self.either(c, 'firefox', 'opera')
if f.extension == 'nes':
return self.app_fceux(c)
if f.extension in ('swc', 'smc'):
return self.app_zsnes(c)
if f.mimetype is not None:
if INTERPRETED_LANGUAGES.match(f.mimetype):
return self.app_edit_or_run(c)
if f.container:
return self.app_aunpack(c)
if f.video or f.audio:
if f.video:
c.flags += 'd'
return self.either(c, 'mplayer', 'totem')
if f.image:
return self.either(c, 'feh', 'eye_of_gnome', 'mirage')
if f.document or f.filetype.startswith('text'):
return self.app_editor(c)
# ----------------------------------------- application definitions
def app_pager(self, c):
return tup('less', *c)
def app_editor(self, c):
try:
default_editor = os.environ['EDITOR']
except KeyError:
pass
else:
parts = default_editor.split()
exe_name = os.path.basename(parts[0])
if exe_name in get_executables():
return tuple(parts) + tuple(c)
return self.either(c, 'vim', 'emacs', 'nano')
@depends_on(app_editor, Applications.app_self)
def app_edit_or_run(self, c):
if c.mode is 1:
return self.app_self(c)
return self.app_editor(c)
@depends_on('mplayer')
def app_mplayer(self, c):
if c.mode is 1:
return tup('mplayer', '-fs', *c)
elif c.mode is 2:
args = "mplayer -fs -sid 0 -vfm ffmpeg -lavdopts " \
"lowres=1:fast:skiploopfilter=all:threads=8".split()
args.extend(c)
return tup(*args)
elif c.mode is 3:
return tup('mplayer', '-mixer', 'software', *c)
else:
return tup('mplayer', *c)
@depends_on('feh')
def app_feh(self, c):
arg = {1: '--bg-scale', 2: '--bg-tile', 3: '--bg-center'}
c.flags += 'd'
if c.mode in arg:
return tup('feh', arg[c.mode], c.file.path)
if c.mode is 4:
return self.app_gimp(c)
if len(c.files) > 1:
return tup('feh', *c)
try:
from collections import deque
directory = self.fm.env.get_directory(c.file.dirname)
images = [f.path for f in directory.files if f.image]
position = images.index(c.file.path)
deq = deque(images)
deq.rotate(-position)
return tup('feh', *deq)
except:
return tup('feh', *c)
@depends_on('aunpack')
def app_aunpack(self, c):
if c.mode is 0:
c.flags += 'p'
return tup('aunpack', '-l', c.file.path)
return tup('aunpack', c.file.path)
@depends_on('make')
def app_make(self, c):
if c.mode is 0:
return tup("make")
if c.mode is 1:
return tup("make", "install")
if c.mode is 2:
return tup("make", "clear")
@depends_on('java')
def app_java(self, c):
def strip_extensions(file):
if '.' in file.basename:
return file.path[:file.path.index('.')]
return file.path
files_without_extensions = map(strip_extensions, c.files)
return tup("java", files_without_extensions)
@depends_on('totem')
def app_totem(self, c):
if c.mode is 0:
return tup("totem", *c)
if c.mode is 1:
return tup("totem", "--fullscreen", *c)
INTERPRETED_LANGUAGES = re.compile(r'''
^(text|application)/x-(
haskell|perl|python|ruby|sh
)$''', re.VERBOSE)