Guía Completa de Ranger

sudo apt-get update
sudo apt-get install ranger

sudo dnf install ranger

sudo pacman -S ranger

brew install ranger

pip install ranger-fm
# O mejor con pipx (entorno aislado)
pipx install ranger-fm

git clone https://github.com/ranger/ranger.git
cd ranger
sudo make install

ranger --version

# Copiar todas las configuraciones
ranger --copy-config=all

# Copiar archivos específicos
ranger --copy-config=rc          # Configuración principal
ranger --copy-config=rifle       # Configuración de rifle
ranger --copy-config=scope       # Script de previsualización
ranger --copy-config=commands    # Comandos personalizados

~/.config/ranger/
├── rc.conf           # Configuración principal y atajos
├── rifle.conf        # Lanzador de archivos
├── scope.sh          # Script de previsualización
├── commands.py       # Comandos personalizados (Python)
├── commands_full.py  # Comandos adicionales
└── plugins/          # Directorio para plugins

ranger

┌─────────────────────────────────────────────────────────┐
│ Directorio Padre │ Directorio Actual │ Previsualización │
│                  │                   │                  │
│  parent/         │ > archivo1.txt    │ Contenido del    │
│  current/        │   archivo2.py     │ archivo1.txt...  │
│  sibling/        │   carpeta/        │                  │
│                  │   imagen.png      │                  │
│                  │                   │                  │
├─────────────────────────────────────────────────────────┤
│ Barra de Estado: PWD, permisos, tamaño, fecha           │
└─────────────────────────────────────────────────────────┘

+x    # Añadir permiso de ejecución
-w    # Quitar permiso de escritura
=755  # Establecer permisos exactos

# Seleccionar archivos con Space
# Ejecutar:
:bulkrename

# Se abre tu editor con lista de archivos
# Edita los nombres
# Guarda y cierra
# Ranger renombra los archivos automáticamente

# Con números
1gt   # Ir a pestaña 1
3gt   # Ir a pestaña 3

# Navegación relativa
gt    # Siguiente
gT    # Anterior

# Estás en /home/usuario/documentos
ma        # Crear marcador 'a'

cd /etc   # Navega a otro lugar

# Volver rápido
'a        # Regresa a /home/usuario/documentos

:marks    # Ver todos los marcadores

# En scope.sh, añadir nuevo caso
case "$mimetype" in
    application/json)
        jq . "$path" && exit 5
        cat "$path" && exit 5
        exit 1;;
esac

:cd <directorio>           # Cambiar directorio
:cd -                      # Directorio anterior
:cd ~                      # Ir a HOME

:touch <nombre>            # Crear archivo
:mkdir <nombre>            # Crear directorio
:rename <nuevo_nombre>     # Renombrar
:delete                    # Eliminar con confirmación
:chmod <permisos>          # Cambiar permisos

:search <patrón>           # Buscar archivos
:search_inc <patrón>       # Búsqueda incremental
:filter <patrón>           # Filtrar archivos mostrados

:tab_new                   # Nueva pestaña
:tab_close                 # Cerrar pestaña
:tab_move <n>              # Mover a pestaña n
:mark <letra>              # Crear marcador

:set <opción> <valor>      # Establecer opción
:set show_hidden true      # Mostrar archivos ocultos
:set column_ratios 1,3,4   # Cambiar proporciones de columnas
:set colorscheme <nombre>  # Cambiar tema de colores

:help                      # Abrir ayuda
:source <archivo>          # Cargar configuración
:shell <comando>           # Ejecutar comando shell
:quit                      # Salir

# Ejecutar comando y ver output
!ls -la

# Ejecutar en segundo plano
!make &

# Ejecutar con privilegios
S
# O
!sudo <comando>

# Mostrar archivos ocultos
set show_hidden true

# Cambiar editor por defecto
set editor vim
# set editor nano
# set editor code

# Proporciones de columnas (padre:actual:previsualización)
set column_ratios 1,3,4

# Confirmación antes de eliminar
set confirm_on_delete multiple

# Mostrar números de línea
set line_numbers relative
# Opciones: false, absolute, relative

# Tema de colores
set colorscheme default
# Otros: jungle, snow, solarized

# Previsualización automática
set preview_files true
set preview_directories true
set preview_images true

# Método de previsualización de imágenes
set preview_images_method w3m
# Opciones: w3m, ueberzug, kitty, iterm2
set preview_images_method kitty

# Guardar historial
set save_console_history true

# Tamaño máximo de previsualización
set preview_max_size 0  # 0 = sin límite

# Mostrar información VCS (git)
set vcs_aware true

# Comportamiento del mouse
set mouse_enabled true

# Scroll automático
set autosave_bookmarks true
set autoupdate_cumulative_size false

# Padding alrededor de la selección
set padding_right true

# Mapear tecla a comando
map <tecla> <comando>

# Ejemplos:
map DD shell trash-put %s          # Mover a papelera
map x shell chmod +x %s            # Hacer ejecutable
map bg shell feh --bg-scale %s     # Establecer fondo de pantalla
map <C-t> shell alacritty &        # Abrir terminal
map <A-1> tab_move 1               # Ir a pestaña 1
map ee edit_file                   # Editar archivo
map et shell alacritty -e vim %s & # Editar en terminal nueva

# Desmap tecla
unmap dd  # Quitar mapeo de dd

# Ejecutar comando con archivo actual
map X shell -f <comando> %f

# Variables disponibles:
# %f - archivo actual
# %d - directorio actual
# %s - archivos seleccionados
# %t - archivos etiquetados (tagged)
# %c - ruta completa del archivo actual

<condición> = <comando>

# Texto plano
mime ^text, label editor = ${VISUAL:-$EDITOR} -- "$@"
mime ^text, label pager  = "$PAGER" -- "$@"

# PDFs
ext pdf, has evince,  X, flag f = evince -- "$@"
ext pdf, has zathura, X, flag f = zathura -- "$@"
ext pdf, has okular,  X, flag f = okular -- "$@"

# Imágenes
mime ^image, has feh,       X, flag f = feh -- "$@"
mime ^image, has gimp,      X, flag f = gimp -- "$@"
mime ^image, has sxiv,      X, flag f = sxiv -- "$@"

# Videos
mime ^video, has mpv,       X, flag f = mpv -- "$@"
mime ^video, has vlc,       X, flag f = vlc -- "$@"

# Audio
mime ^audio, has mpv,       X, flag f = mpv --no-video -- "$@"

# Archivos comprimidos
ext 7z|ace|ar|arc|bz2?|cab|cpio|cpt|deb|dgc|dmg|gz,  has atool = atool --list --each -- "$@" | "$PAGER"
ext iso|jar|msi|pkg|rar|shar|tar|tgz|xar|xpi|xz|zip, has atool = atool --list --each -- "$@" | "$PAGER"

# Documentos Office
ext docx?|xlsx?|pptx?|odt|ods|odp, has libreoffice, X, flag f = libreoffice "$@"

# HTML
ext html?, has firefox,  X, flag f = firefox -- "$@"
ext html?, has chromium, X, flag f = chromium -- "$@"

# Código fuente
ext py,  has python  = python -- "$1"
ext pl,  has perl    = perl -- "$1"
ext rb,  has ruby    = ruby -- "$1"
ext js,  has node    = node -- "$1"
ext sh,  has sh      = sh -- "$1"

from ranger.api.commands import Command

class compress(Command):
    def execute(self):
        """Comprimir archivos seleccionados"""
        import os
        
        # Obtener archivos seleccionados
        if self.fm.thisdir.marked_items:
            files = [f.basename for f in self.fm.thisdir.marked_items]
        else:
            files = [self.fm.thisfile.basename]
        
        # Nombre del archivo comprimido
        archive_name = self.rest(1) if self.rest(1) else "archive.tar.gz"
        
        # Comprimir
        self.fm.execute_command(f"tar czf {archive_name} {' '.join(files)}")
        self.fm.notify(f"Comprimido como {archive_name}")

class extract(Command):
    def execute(self):
        """Extraer archivo comprimido"""
        if self.fm.thisfile.extension in ['zip', 'tar', 'gz', 'bz2', 'xz']:
            self.fm.execute_command(f"atool -x {self.fm.thisfile.basename}")
            self.fm.notify("Archivo extraído")

class mkcd(Command):
    """Crear directorio y entrar en él"""
    def execute(self):
        from os.path import join, expanduser, lexists
        dirname = join(self.fm.thisdir.path, expanduser(self.rest(1)))
        if not lexists(dirname):
            os.makedirs(dirname)
            self.fm.cd(dirname)
        else:
            self.fm.notify("Directorio ya existe", bad=True)

:compress archivo.tar.gz    # Comprimir selección
:extract                    # Extraer archivo
:mkcd nueva-carpeta         # Crear y entrar

# Abrir archivo con rifle
rifle archivo.pdf

# Listar programas disponibles
rifle -l archivo.pdf

# Abrir con programa específico
rifle -p 2 archivo.pdf  # Usar opción 2 de la lista

# Ejemplo: Abrir PDFs con zathura si está disponible
ext pdf, has zathura, X, flag f = zathura -- "$@"

# Si no, con evince
ext pdf, has evince, X, flag f = evince -- "$@"

# Si no, convertir a texto
ext pdf, has pdftotext = pdftotext -l 10 -nopgbrk -q -- "$@" -

~/.config/ranger/plugins/

git clone https://github.com/alexanderjeurissen/ranger_devicons ~/.config/ranger/plugins/ranger_devicons

default_linemode devicons

git clone https://github.com/maximtrp/ranger-archives.git ~/.config/ranger/plugins/ranger-archives

map f shell fasd -d | fzf --no-sort | xargs -I{} ranger --selectfile "{}"

class fzf_select(Command):
    def execute(self):
        import subprocess
        command = "find -L . -path '*/\.*' -prune -o -print 2> /dev/null | fzf +m"
        fzf = self.fm.execute_command(command, stdout=subprocess.PIPE)
        stdout, stderr = fzf.communicate()
        if fzf.returncode == 0:
            fzf_file = os.path.abspath(stdout.decode('utf-8').rstrip('\n'))
            if os.path.isdir(fzf_file):
                self.fm.cd(fzf_file)
            else:
                self.fm.select_file(fzf_file)

map <C-f> fzf_select

# ~/.config/ranger/plugins/mi_plugin.py
import ranger.api

class CustomCommand(ranger.api.commands.Command):
    def execute(self):
        # Tu código aquí
        self.fm.notify("Hola desde mi plugin!")

# Hook para inicialización
old_hook_init = ranger.api.hook_init

def hook_init(fm):
    # Inicialización personalizada
    fm.notify("Plugin cargado")
    return old_hook_init(fm)

ranger.api.hook_init = hook_init

function ranger-cd {
    tempfile="$(mktemp -t tmp.XXXXXX)"
    ranger --choosedir="$tempfile" "${@:-$(pwd)}"
    test -f "$tempfile" &&
    if [ "$(cat -- "$tempfile")" != "$(echo -n `pwd`)" ]; then
        cd -- "$(cat "$tempfile")"
    fi  
    rm -f -- "$tempfile"
}

# Alias para usar
alias rr='ranger-cd'

function ranger-cd {
    tempfile="$(mktemp -t tmp.XXXXXX)"
    ranger --choosedir="$tempfile" "${@:-$(pwd)}"
    test -f "$tempfile" &&
    if [ "$(cat -- "$tempfile")" != "$(echo -n `pwd`)" ]; then
        cd -- "$(cat "$tempfile")"
    fi  
    rm -f -- "$tempfile"
}

alias rr='ranger-cd'

function ranger-cd
    set tempfile (mktemp -t tmp.XXXXXX)
    ranger --choosedir=$tempfile $argv
    if test -f $tempfile
        if test (cat $tempfile) != (pwd)
            cd (cat $tempfile)
        end
    end
    rm -f $tempfile
end

alias rr='ranger-cd'

#!/bin/bash
# ranger-picker.sh
tempfile="$(mktemp -t tmp.XXXXXX)"
ranger --choosefile="$tempfile"
if [ -f "$tempfile" ]; then
    cat "$tempfile"
    rm -f "$tempfile"
fi

selected_file=$(ranger-picker.sh)
echo "Archivo seleccionado: $selected_file"

sudo apt-get install highlight
# O
cargo install bat

case "$mimetype" in
    text/* | */xml)
        bat --style=numbers --color=always "$path" && exit 5
        exit 2;;
esac

sudo apt-get install ffmpegthumbnailer

sudo apt-get install w3m w3m-img

set preview_images true
set preview_images_method w3m

set preview_images_method kitty

pip install ueberzug
set preview_images_method ueberzug

import subprocess

class fzf(Command):
    def execute(self):
        command="find -L . \( -path '*/\.*' -o -fstype 'dev' -o -fstype 'proc' \) -prune -o -print 2> /dev/null | sed 1d | cut -b3- | fzf +m"
        fzf = self.fm.execute_command(command, stdout=subprocess.PIPE)
        stdout, _ = fzf.communicate()
        if fzf.returncode == 0:
            fzf_file = os.path.abspath(stdout.decode('utf-8').rstrip('\n'))
            if os.path.isdir(fzf_file):
                self.fm.cd(fzf_file)
            else:
                self.fm.select_file(fzf_file)

map <C-f> fzf

set vcs_aware true
set vcs_backend_git enabled

set preview_max_size 10485760  # 10MB
set max_history_size 20
set max_console_history_size 50

# Abrir en VS Code
map code shell code "$PWD"

# Abrir terminal aquí
map tt shell alacritty &

# Abrir file manager GUI
map fm shell nautilus "$PWD" &

# Ejecutar script
map ex shell chmod +x %s && ./%s

# Crear marcador para cloud storage
map gdb cd ~/Dropbox
map gdv cd ~/Google\ Drive

# Seleccionar archivos con Space
# Ejecutar:
:bulkrename

# Se abre editor con lista
# Modificar nombres
# Guardar y cerrar

# JSON
json)
    jq --color-output . "${FILE_PATH}" && exit 5
    python -m json.tool -- "${FILE_PATH}" && exit 5
    ;;

# YAML
yaml)
    yq eval --colors -- "${FILE_PATH}" && exit 5
    ;;

# Verificar método configurado
:set preview_images_method

# Cambiar método
:set preview_images_method w3m
# O kitty, ueberzug, iterm2

# Verificar instalación
which w3mimgdisplay

# Verificar TERM
echo $TERM

# Debería ser xterm-256color o similar
export TERM=xterm-256color

# En rc.conf cambiar colorscheme
set colorscheme default

# Instalar highlight o pygments
sudo apt-get install highlight

# O
pip install pygments

# Verificar scope.sh está configurado correctamente

# En rc.conf
set preview_max_size 1048576  # 1MB
set preview_images false
set max_history_size 10

# Debe estar en ~/.bashrc o ~/.zshrc
function ranger-cd { ... }
alias rr='ranger-cd'

# Presionar
zh

# O en rc.conf
set show_hidden true

# Verificar PATH
echo $PATH

# Editar rifle.conf para usar rutas absolutas
ext pdf = /usr/bin/zathura -- "$@"