https://github.com/alexanderjeurissen/ranger_devicons

Ranger plugin that adds file glyphs / icon support to Ranger
https://github.com/alexanderjeurissen/ranger_devicons

devicons file-icons nerd-fonts ranger

Last synced: 6 days ago
JSON representation

Ranger plugin that adds file glyphs / icon support to Ranger

• Host: GitHub
• URL: https://github.com/alexanderjeurissen/ranger_devicons
• Owner: alexanderjeurissen
• License: gpl-3.0
• Created: 2017-03-09T20:01:32.000Z (almost 8 years ago)
• Default Branch: main
• Last Pushed: 2025-01-08T22:28:13.000Z (17 days ago)
• Last Synced: 2025-01-13T06:00:42.599Z (13 days ago)
• Topics: devicons, file-icons, nerd-fonts, ranger
• Language: Python
• Homepage:
• Size: 188 KB
• Stars: 985
• Watchers: 13
• Forks: 76
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.MD
  • License: LICENSE

Awesome Lists containing this project

• awesome - alexanderjeurissen/ranger_devicons - Ranger plugin that adds file glyphs / icon support to Ranger (Python)
• awesome-starred - ranger_devicons - Ranger plugin that adds file glyphs / icon support to Ranger (Python)
• ranger-awesome - ranger\_devicons
• awesome-linux-ricing - devicons

README

        
# File icons for the Ranger file manager

This plugin introduces a new linemode that prefixes file names with a file icon

![image](screenshot.png)

## Prerequisites

This plugin uses glyphs from a patched NERDfont. So in order for this plugin to work you need to install a NERDfont and set it as the default font for your terminal.

I personally use the Source Code Pro patched NERDfont(this is also the font displayed in the screenshot), this and other NERDfonts and the install instructions for these fonts can be found in the [following repository](https://github.com/ryanoasis/nerd-fonts)

## Install instructions

Ranger has added support for loading directories in the plugins folder which makes it easier to install and keep plugins updated.

To install, just clone the repo into the plugins folder:

```bash

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

```

Then execute the following `echo "default_linemode devicons" >> $HOME/.config/ranger/rc.conf` (or wherever your `rc.conf` is located).

## Configuration

This plugin can be configured by setting environment variables (e.g. in your

`~/.profile`). Currently, only one option is available:

- `RANGER_DEVICONS_SEPARATOR` (default `" "`, i.e. a single space): The

  separator between icon and filename. Some terminals use the adjacent space to

  display a bigger icon, in which case this can be set to two spaces instead.