Difference between revisions of "Ranger"

From ArchWiki
Jump to: navigation, search
m (updated pdf file preview with new variables and to replace lines for v1.8 and 1.9 (ranger-git). Also specified that by default, text will be produced as a preview)
m (Fixed typos, grammatical errors, and inconsistencies because the article is pretty messy)
 
(36 intermediate revisions by 21 users not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:ranger}}
 
{{DISPLAYTITLE:ranger}}
 
[[Category:File managers]]
 
[[Category:File managers]]
 +
[[Category:Console applications]]
 
[[ar:Ranger]]
 
[[ar:Ranger]]
 +
[[es:Ranger]]
 +
[[fa:ranger]]
 
[[fr:ranger]]
 
[[fr:ranger]]
 
[[ja:Ranger]]
 
[[ja:Ranger]]
Line 9: Line 12:
 
{{Related|vifm}}
 
{{Related|vifm}}
 
{{Related articles end}}
 
{{Related articles end}}
[http://ranger.nongnu.org/ ranger] is a text-based file manager written in Python. Directories are displayed in one pane with three columns. Moving between them is accomplished with keystrokes, bookmarks, the mouse or the command history. File previews and directory contents show automatically for the current selection.
+
[http://ranger.github.io/ ranger] is a text-based file manager written in [[Python]]. Directories are displayed in one pane with three columns. Moving between them is accomplished with keystrokes, bookmarks, the mouse or the command history. File previews and directory contents show automatically for the current selection.
  
Features include: vi-style key bindings, bookmarks, selections, tagging, tabs, command history, the ability to make symbolic links, several console modes, and a task view.  ''ranger'' has customizable commands and key bindings, including bindings to external scripts. The closest competitor is [[Vifm]], which has two panes and vi-style key bindings, but fewer features overall.
+
Features include: [[vi]]-style key bindings, bookmarks, selections, tagging, tabs, command history, the ability to make symbolic links, several console modes, and a task view.  ''ranger'' has customizable commands and key bindings, including bindings to external scripts. Ranger also comes with its own [[file opener]], {{man|1|rifle}}. The closest competitors are [[Vifm]] and [https://github.com/gokcehan/lf lf].
  
 
== Installation ==
 
== Installation ==
Line 31: Line 34:
 
== Configuration ==
 
== Configuration ==
  
After startup, ''ranger'' creates a directory {{ic|~/.config/ranger}}. To copy the default configuration to this directory issue the following command:
+
After startup, ranger creates a directory {{ic|~/.config/ranger}}. To copy the default configuration to this directory issue the following command:
  
  ranger --copy-config=all
+
  $ ranger --copy-config=all
  
 
* {{ic|rc.conf}} - startup commands and key bindings
 
* {{ic|rc.conf}} - startup commands and key bindings
Line 43: Line 46:
 
  from ranger.api.commands import *
 
  from ranger.api.commands import *
  
To add a keybind that moves files to a created directory {{ic|~/.Trash/}} with {{ic|DD}}, add to {{ic|~/.config/ranger/rc.conf}}:
+
See {{man|1|ranger}} for general configuration.
  
map DD shell mv -t /home/${USER}/.Trash %s
+
=== Move to trash ===
  
See [http://ranger.nongnu.org/ranger.1.html man ranger] for general configuration.
+
To add a keybind that moves files to your trash directory {{ic|~/.local/share/Trash/files/}} with {{ic|DD}}, add to {{ic|~/.config/ranger/rc.conf}}:
 +
 
 +
map DD shell mv %s /home/${USER}/.local/share/Trash/files/
 +
 
 +
Alternatively, use GIO commandline tool provided by {{Pkg|glib2}} package:
 +
 
 +
map DD shell gio trash %s
 +
 
 +
Inspecting and emptying the "trash" is normally supported by graphical file managers such as {{Pkg|nautilus}}, but you can also see the trash with the command {{ic|gio list trash://}}, and empty it with: {{ic|gio trash --empty}}.
  
 
=== Defining commands ===
 
=== Defining commands ===
Line 91: Line 102:
 
== Tips and tricks ==
 
== Tips and tricks ==
  
{{Template:Poor writing|}}
+
{{Template:Style|bad style}}
  
 
=== Archives ===
 
=== Archives ===
Line 139: Line 150:
 
==== Compression ====
 
==== Compression ====
  
The following command allows the user to compress several files on the current directory by marking them and then calling {{ic|:compress ''package name''}}. It supports name suggestions by getting the basename of the current directory and appending several possibilities for the extension. You need to have {{pkg|atool}} installed. Otherwise you will see an error message when you create the archive.
+
The following command allows users to compress several files on the current directory by marking them and then calling {{ic|:compress ''package name''}}. It supports name suggestions by getting the basename of the current directory and appending several possibilities for the extension. You need to have {{pkg|atool}} installed, otherwise you will see an error message when you create the archive.
  
 
{{bc|<nowiki>
 
{{bc|<nowiki>
Line 179: Line 190:
  
 
External drives can be automatically mounted with [[udev]] or [[udisks]]. Drives mounted under {{ic|/media}} can be easily accessed by pressing {{ic|gm}} (go, media).
 
External drives can be automatically mounted with [[udev]] or [[udisks]]. Drives mounted under {{ic|/media}} can be easily accessed by pressing {{ic|gm}} (go, media).
 +
 +
=== Hidden files ===
 +
 +
You can toggle the visibility of hidden files with the following command: {{ic|:set show_hidden!}}, or use {{ic|:set show_hidden true}} to make hidden files visible.
 +
 +
To make this permanent, add the setting to your configuration file:
 +
 +
{{hc|rc.conf|<nowiki>
 +
set show_hidden true
 +
</nowiki>}}
 +
 +
Alternatively, hidden files can be toggled by pressing {{ic|zh}}.
  
 
=== Image mounting ===
 
=== Image mounting ===
Line 237: Line 260:
 
         self.fm.loader.add(obj)
 
         self.fm.loader.add(obj)
 
</nowiki>}}
 
</nowiki>}}
 +
  
 
=== New tab in current folder ===
 
=== New tab in current folder ===
Line 246: Line 270:
  
 
=== PDF file preview ===
 
=== PDF file preview ===
By default ranger will preview PDF files as text. However, you can preview PDF files as an image in ranger by first converting the PDF file to an image. Ranger stores the image previews in {{ic|~/.cache/ranger/}}.
+
By default, ranger will preview PDF files as text. However, you can preview PDF files as an image in ranger by first converting the PDF file to an image. Ranger stores the image previews in {{ic|~/.cache/ranger/}}. You either need to create this directory manually or set {{ic|preview_images}} to {{ic|true}} in {{ic|~/.config/ranger/rc.conf}} to tell {{ic|ranger}} to create it automatically at the next start.  However, note that {{ic|preview_images}} does not need to be set to {{ic|true}} the whole time to preview PDF file as images, only {{ic|~/.cache/ranger}} directory is needed.
  
First, ensure image preview is enabled:
+
To enable this feature, uncomment the appropriate lines in {{ic|/usr/share/doc/ranger/config/scope.sh}}, or add/uncomment these lines in your local file {{ic|~/.config/ranger/scope.sh}}.
 
 
{{hc|~/.config/ranger/rc.conf|<nowiki>
 
# Use one of the supported image preview protocols
 
set preview_images true
 
</nowiki>}}
 
 
 
Ranger can preview images using, for example, {{Pkg|w3m}}; see {{ic|~/.config/ranger/rc.conf}} for all available preview methods.
 
 
 
Finally, replace the following lines under {{ic|pdf)}} in {{ic|handle_extension()}} (62-64 by default):
 
 
 
{{hc|~/.config/ranger/scope.sh|<nowiki>
 
          # Preview as text conversion
 
          pdftotext -l 10 -nopgbrk -q -- "${FILE_PATH}" - && exit 5
 
          exiftool "${FILE_PATH}" && exit 5                       
 
</nowiki>}}
 
 
 
with:
 
 
 
{{hc|~/.config/ranger/scope.sh|<nowiki>
 
          # Preview as image conversion
 
          pdftoppm -jpeg -singlefile "${FILE_PATH}" "${IMAGE_CACHE_PATH//.jpg}" && exit 6
 
</nowiki>}}
 
 
 
In this example the {{ic|pdftoppm}} utility from {{Pkg|poppler}} is used to create the image preview. Other (usually slower) options are available, for example {{Pkg|ghostscript}} or {{Pkg|imagemagick}}.
 
  
 
=== Shell tips ===
 
=== Shell tips ===
Line 278: Line 278:
 
==== Synchronize path ====
 
==== Synchronize path ====
  
''ranger'' provides a shell [[Bash/Functions|function]] {{ic|/usr/share/doc/ranger/examples/bash_automatic_cd.sh}}. Running {{ic|ranger-cd}} instead of {{ic|ranger}} will automatically ''cd'' to the last browsed folder.
+
Ranger provides a shell [[Bash/Functions|function]] {{ic|/usr/share/doc/ranger/examples/bash_automatic_cd.sh}}. Running {{ic|ranger-cd}} instead of {{ic|ranger}} will automatically ''cd'' to the last browsed folder.
  
If you launch ranger from a graphical launcher (such as {{ic|$TERMCMD -e ranger}}, where TERMCMD is an X terminal), you cannot use {{ic|ranger-cd}}. Create an executable script:
+
If you launch ranger from a graphical launcher (such as {{ic|$TERMCMD -e ranger}}, where TERMCMD is an X terminal), you cannot use {{ic|ranger-cd}}. Instead, create an executable script:
  
 
{{hc|ranger-launcher.sh|<nowiki>
 
{{hc|ranger-launcher.sh|<nowiki>
Line 288: Line 288:
 
</nowiki>}}
 
</nowiki>}}
  
and add at the ''very end'' of your shell configuration:
+
And add the following at the end of your shell configuration:
  
 
{{hc|.''shell''rc|<nowiki>
 
{{hc|.''shell''rc|<nowiki>
Line 320: Line 320:
 
}}
 
}}
  
Alternatively, you can make use of your shell history file if it has any. For instance, you could do this for [[zsh#Dirstack|zsh]]:
+
Alternatively, you can make use of your shell history file if it has one. For instance, you could do this for [[zsh#Dirstack|zsh]]:
  
 
{{hc|shellcd|<nowiki>
 
{{hc|shellcd|<nowiki>
Line 347: Line 347:
 
When you however forget that you already are in a ranger shell and start ranger again you end up with ranger running a shell running ranger.
 
When you however forget that you already are in a ranger shell and start ranger again you end up with ranger running a shell running ranger.
  
To prevent this you can create the following function in your [[Autostarting#Shells|shell's startup file]]:
+
To prevent this you can create the following function in your [[Autostarting#On_shell_login_.2F_logout|shell's startup file]]:
  
 
  ranger() {
 
  ranger() {
Line 356: Line 356:
 
     fi
 
     fi
 
  }
 
  }
 +
 +
=== Custom linemodes ===
 +
 +
{{Expansion|Explain what linemodes are.}}
 +
 +
==== BIDI linemode ====
 +
 +
{{Style|Comments and explanations belong into plain text, not into the code.}}
 +
 +
{{hc|plugin_bidi.py|<nowiki>
 +
# ~/.config/ranger/plugins/plugin_bidi.py
 +
#
 +
# Compatible since ranger 1.7.0
 +
#
 +
# This plugin adds a new linemode displaying the filename according to
 +
# UAX #9, Unicode Bidirectional Algorithm.
 +
# It depends on python-bidi, https://github.com/MeirKriheli/python-bidi.
 +
# Load this plugin by copying it to ~/.config/ranger/plugins/ and activate
 +
# the linemode by typing ":linemode bidi" in ranger.  Type Mf to restore
 +
# the default linemode.
 +
# Set this as the default linemode by adding "default_linemode bidi"
 +
# to your rc.conf.
 +
 +
from __future__ import (absolute_import, division, print_function)
 +
 +
from bidi import algorithm
 +
 +
import ranger.api
 +
from ranger.core.linemode import LinemodeBase
 +
 +
 +
@ranger.api.register_linemode
 +
class MyLinemode(LinemodeBase):
 +
    name = "bidi"
 +
 +
    def filetitle(self, fobj, metadata):
 +
        return algorithm.get_display(fobj.relative_path)
 +
 +
    def infostring(self, fobj, metadata):
 +
        raise NotImplementedError
 +
</nowiki>}}
  
 
== Troubleshooting ==
 
== Troubleshooting ==
Line 370: Line 411:
 
* [http://dotshare.it/category/fms/ranger/ DotShare.it configurations]
 
* [http://dotshare.it/category/fms/ranger/ DotShare.it configurations]
 
* [https://github.com/hut/ranger GitHub]
 
* [https://github.com/hut/ranger GitHub]
 +
* [https://github.com/ranger/ranger/wiki/Official-user-guide Official User Guide]
 
* [https://www.digitalocean.com/community/tutorials/installing-and-using-ranger-a-terminal-file-manager-on-a-ubuntu-vps Installing and using ranger]
 
* [https://www.digitalocean.com/community/tutorials/installing-and-using-ranger-a-terminal-file-manager-on-a-ubuntu-vps Installing and using ranger]
 
* [https://lists.nongnu.org/mailman/listinfo/ranger-users Mailing list]
 
* [https://lists.nongnu.org/mailman/listinfo/ranger-users Mailing list]
 
* [https://bloerg.net/2012/10/17/ranger-file-manager.html Ranger tutorial]
 
* [https://bloerg.net/2012/10/17/ranger-file-manager.html Ranger tutorial]

Latest revision as of 07:48, 10 December 2018

ranger is a text-based file manager written in Python. Directories are displayed in one pane with three columns. Moving between them is accomplished with keystrokes, bookmarks, the mouse or the command history. File previews and directory contents show automatically for the current selection.

Features include: vi-style key bindings, bookmarks, selections, tagging, tabs, command history, the ability to make symbolic links, several console modes, and a task view. ranger has customizable commands and key bindings, including bindings to external scripts. Ranger also comes with its own file opener, rifle(1). The closest competitors are Vifm and lf.

Installation

Install the ranger package, or ranger-gitAUR for the development version.

Usage

To start ranger, launch a terminal and run ranger.

Key Command
? Open the manual or list keybindings, commands and settings
l, Enter Launch files

Configuration

After startup, ranger creates a directory ~/.config/ranger. To copy the default configuration to this directory issue the following command:

$ ranger --copy-config=all
  • rc.conf - startup commands and key bindings
  • commands.py - commands which are launched with :
  • rifle.conf - applications used when a given type of file is launched.

rc.conf only needs to include changes from the default file as both are loaded. For commands.py, if you do not include the whole file, put this line at the top:

from ranger.api.commands import *

See ranger(1) for general configuration.

Move to trash

To add a keybind that moves files to your trash directory ~/.local/share/Trash/files/ with DD, add to ~/.config/ranger/rc.conf:

map DD shell mv %s /home/${USER}/.local/share/Trash/files/

Alternatively, use GIO commandline tool provided by glib2 package:

map DD shell gio trash %s

Inspecting and emptying the "trash" is normally supported by graphical file managers such as nautilus, but you can also see the trash with the command gio list trash://, and empty it with: gio trash --empty.

Defining commands

Continuing the above example, add the following entry to ~/.config/ranger/commands.py to empty the trash directory ~/.Trash.

class empty(Command):
    """:empty

    Empties the trash directory ~/.Trash
    """

    def execute(self):
        self.fm.run("rm -rf /home/myname/.Trash/{*,.[^.]*}")

To use it, type :empty and Enter with tab completion as desired.

Warning: [^.] is an essential part of the above command. Without it, all files and directories of the form ..* will be deleted, wiping out everything in your home directory.

Color schemes

Ranger comes with four color schemes: default, jungle, snow and solarized. You can change your color scheme using:

set colorscheme scheme

Custom color schemes can be placed in ~/.config/ranger/colorschemes.

File association

Ranger uses its own file opener called rifle. It's configured in ~/.config/ranger/rifle.conf. Run ranger --copy-config=rifle if it does not exist. For example, the following line makes kile the default program for tex files:

ext tex = kile "$@"

To open all files with xdg-utils:

has xdg-open, flag f = xdg-open "$1"

Tips and tricks

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements. See Help:Style for reference.Tango-edit-clear.png

Reason: bad style (Discuss in Talk:Ranger#)

Archives

These commands use atool to perform archive operations.

Archive extraction

The following command implements archive extraction by copying (yy) one or more archive files and then executing :extracthere on the desired directory.

import os
from ranger.core.loader import CommandLoader

class extracthere(Command):
    def execute(self):
        """ Extract copied files to current directory """
        copied_files = tuple(self.fm.copy_buffer)

        if not copied_files:
            return

        def refresh(_):
            cwd = self.fm.get_directory(original_path)
            cwd.load_content()

        one_file = copied_files[0]
        cwd = self.fm.thisdir
        original_path = cwd.path
        au_flags = ['-X', cwd.path]
        au_flags += self.line.split()[1:]
        au_flags += ['-e']

        self.fm.copy_buffer.clear()
        self.fm.cut_buffer = False
        if len(copied_files) == 1:
            descr = "extracting: " + os.path.basename(one_file.path)
        else:
            descr = "extracting files from: " + os.path.basename(one_file.dirname)
        obj = CommandLoader(args=['aunpack'] + au_flags \
                + [f.path for f in copied_files], descr=descr)

        obj.signal_bind('after', refresh)
        self.fm.loader.add(obj)

Compression

The following command allows users to compress several files on the current directory by marking them and then calling :compress package name. It supports name suggestions by getting the basename of the current directory and appending several possibilities for the extension. You need to have atool installed, otherwise you will see an error message when you create the archive.

import os
from ranger.core.loader import CommandLoader

class compress(Command):
    def execute(self):
        """ Compress marked files to current directory """
        cwd = self.fm.thisdir
        marked_files = cwd.get_selection()

        if not marked_files:
            return

        def refresh(_):
            cwd = self.fm.get_directory(original_path)
            cwd.load_content()

        original_path = cwd.path
        parts = self.line.split()
        au_flags = parts[1:]

        descr = "compressing files in: " + os.path.basename(parts[1])
        obj = CommandLoader(args=['apack'] + au_flags + \
                [os.path.relpath(f.path, cwd.path) for f in marked_files], descr=descr)

        obj.signal_bind('after', refresh)
        self.fm.loader.add(obj)

    def tab(self):
        """ Complete with current folder name """

        extension = ['.zip', '.tar.gz', '.rar', '.7z']
        return ['compress ' + os.path.basename(self.fm.thisdir.path) + ext for ext in extension]

External drives

External drives can be automatically mounted with udev or udisks. Drives mounted under /media can be easily accessed by pressing gm (go, media).

Hidden files

You can toggle the visibility of hidden files with the following command: :set show_hidden!, or use :set show_hidden true to make hidden files visible.

To make this permanent, add the setting to your configuration file:

rc.conf
set show_hidden true

Alternatively, hidden files can be toggled by pressing zh.

Image mounting

The following command assumes you are using CDemu as your image mounter and some kind of system like autofs which mounts the virtual drive to a specified location ('/media/virtualrom' in this case). Do not forget to change mountpath to reflect your system settings.

To mount an image (or images) to a cdemud virtual drive from ranger you select the image files and then type ':mount' on the console. The mounting may actually take some time depending on your setup (in mine it may take as long as one minute) so the command uses a custom loader that waits until the mount directory is mounted and then opens it on the background in tab 9.

import os, time
from ranger.core.loader import Loadable
from ranger.ext.signals import SignalDispatcher
from ranger.ext.shell_escape import *

class MountLoader(Loadable, SignalDispatcher):
    """
    Wait until a directory is mounted
    """
    def __init__(self, path):
        SignalDispatcher.__init__(self)
        descr = "Waiting for dir '" + path + "' to be mounted"
        Loadable.__init__(self, self.generate(), descr)
        self.path = path

    def generate(self):
        available = False
        while not available:
            try:
                if os.path.ismount(self.path):
                    available = True
            except:
                pass
            yield
            time.sleep(0.03)
        self.signal_emit('after')

class mount(Command):
    def execute(self):
        selected_files = self.fm.thisdir.get_selection()

        if not selected_files:
            return

        space = ' '
        self.fm.execute_command("cdemu -b system unload 0")
        self.fm.execute_command("cdemu -b system load 0 " + \
                space.join([shell_escape(f.path) for f in selected_files]))
 
        mountpath = "/media/virtualrom/"

        def mount_finished(path):
            currenttab = self.fm.current_tab
            self.fm.tab_open(9, mountpath)
            self.fm.tab_open(currenttab)

        obj = MountLoader(mountpath)
        obj.signal_bind('after', mount_finished)
        self.fm.loader.add(obj)


New tab in current folder

You may have noticed there are two shortcuts for opening a new tab in home (gn and Ctrl+n). Let us rebind Ctrl+n:

rc.conf
map <c-n>  eval fm.tab_new('%d')

PDF file preview

By default, ranger will preview PDF files as text. However, you can preview PDF files as an image in ranger by first converting the PDF file to an image. Ranger stores the image previews in ~/.cache/ranger/. You either need to create this directory manually or set preview_images to true in ~/.config/ranger/rc.conf to tell ranger to create it automatically at the next start. However, note that preview_images does not need to be set to true the whole time to preview PDF file as images, only ~/.cache/ranger directory is needed.

To enable this feature, uncomment the appropriate lines in /usr/share/doc/ranger/config/scope.sh, or add/uncomment these lines in your local file ~/.config/ranger/scope.sh.

Shell tips

Synchronize path

Ranger provides a shell function /usr/share/doc/ranger/examples/bash_automatic_cd.sh. Running ranger-cd instead of ranger will automatically cd to the last browsed folder.

If you launch ranger from a graphical launcher (such as $TERMCMD -e ranger, where TERMCMD is an X terminal), you cannot use ranger-cd. Instead, create an executable script:

ranger-launcher.sh
#!/bin/sh
export RANGERCD=true
$TERMCMD

And add the following at the end of your shell configuration:

.shellrc
$RANGERCD && unset RANGERCD && ranger-cd

This will launch ranger-cd only if the RANGERCD variable is set. It is important to unset this variable again, otherwise launching a subshell from this terminal will automatically relaunch ranger.

Start a shell from ranger

With the previous method you can switch to a shell in last browsed path simply by leaving ranger. However you may not want to quit ranger for several reasons (numerous opened tabs, copy in progress, etc.). You can start a shell from ranger (S by default) without losing your ranger session. Unfortunately, the shell will not switch to the current folder automatically. Again, this can be solved with an executable script:

shellcd
#!/bin/sh
export AUTOCD="$(realpath "$1")"

$SHELL

and - as before - add this to at the very end of your shell configuration:

shellrc
cd "$AUTOCD"

Now you can change your shell binding for ranger:

rc.conf
map S shell shellcd %d

Alternatively, you can make use of your shell history file if it has one. For instance, you could do this for zsh:

shellcd
## Prepend argument to zsh dirstack.
BUF="$(realpath "$1")
$(grep -v "$(realpath "$1")" "$ZDIRS")"
echo "$BUF" > "$ZDIRS"

zsh

Change ZDIRS for your dirstack.

A simpler solution
rc.conf
map S shell bash -c "cd %d; bash"

This could probably be adapted to other shells as well. Instead of just running a shell (like the default config), this will run cd in a shell, then execute a interactive shell which will not immediately exit so that you can continue with what you wanted.

Preventing nested ranger instances

You can start a shell in the current directory with S, when you exit the shell you get back to your ranger instance.

When you however forget that you already are in a ranger shell and start ranger again you end up with ranger running a shell running ranger.

To prevent this you can create the following function in your shell's startup file:

ranger() {
    if [ -z "$RANGER_LEVEL" ]; then
        /usr/bin/ranger "$@"
    else
        exit
    fi
}

Custom linemodes

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: Explain what linemodes are. (Discuss in Talk:Ranger#)

BIDI linemode

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements. See Help:Style for reference.Tango-edit-clear.png

Reason: Comments and explanations belong into plain text, not into the code. (Discuss in Talk:Ranger#)
plugin_bidi.py
# ~/.config/ranger/plugins/plugin_bidi.py
#
# Compatible since ranger 1.7.0
#
# This plugin adds a new linemode displaying the filename according to
# UAX #9, Unicode Bidirectional Algorithm.
# It depends on python-bidi, https://github.com/MeirKriheli/python-bidi.
# Load this plugin by copying it to ~/.config/ranger/plugins/ and activate
# the linemode by typing ":linemode bidi" in ranger.  Type Mf to restore
# the default linemode.
# Set this as the default linemode by adding "default_linemode bidi"
# to your rc.conf.

from __future__ import (absolute_import, division, print_function)

from bidi import algorithm

import ranger.api
from ranger.core.linemode import LinemodeBase


@ranger.api.register_linemode
class MyLinemode(LinemodeBase):
    name = "bidi"

    def filetitle(self, fobj, metadata):
        return algorithm.get_display(fobj.relative_path)

    def infostring(self, fobj, metadata):
        raise NotImplementedError

Troubleshooting

Artifacts in image preview

Borderless columns may cause stripes in image previews. [1] In ~/.config/ranger/rc.conf set:

set draw_borders true

See also