Graphene

A simple asynchronous file explorer.

A developer should not be hindered by their file explorer.

Graphene allows you to easily browse your project, folder by folder, creating files, moving them around, and perhaps most importantly: opening them.

Graphene is not a tree viewer. The mind only has so much capacity, and as such, Graphene focuses on your immediate surroundings letting you be focused on the files at hand.

Setup

Simply call:

require "graphene".setup {}

Configuration

local actions = require "graphene.actions"

require "graphene".setup {
  format_item = require "graphene.icons".format,
  highlight_items = require "graphene.icons".highlight,
  sort = default_sort,
  override_netrw = true,
  mappings = {
    ["<CR>"] = actions.edit,
    ["<Tab>"] = actions.edit,
    ["q"] = actions.quit,
    ["l"] = actions.edit,
    ["<C-s>"] = actions.split,
    ["<C-v>"] = actions.vsplit,
    ["u"] = actions.up,
    ["h"] = actions.up,
    ["i"] = actions.open,
    ["r"] = actions.rename,
    ["D"] = actions.delete,
    [","] = actions.toggle_selected,
    ["y"] = actions.yank,
    ["d"] = actions.cut,
    ["p"] = actions.paste,
    ["<C-o>"] = actions.open_dir_external,
    ["o"] = actions.open_external,
  }

Usage

:edit . " Open cwd
:edit /path/to/directory

or

Graphene " Open directory of current file
Graphene . " Open cwd

Graphene is also accessible through a lua api, if desired.

lua require"graphene".init([path])

Bulk File Operations

At any point, or or more files can be selected with ,.

Use d to cut the files.

Navigate or create a folder and hit p to paste. The files will be moved to the new location.

Use y to copy the marked files, and paste them with p.

If in visual mode, the currently selected lines will be used instead of the marked items.

The clipboard is shared between all graphene instances, which means you can copy, cut and paste between splits.

Use d to cut the files.

Navigate or create a folder and hit p to paste. The files will be moved to the new location.

Use y to copy the marked files, and paste them with p.

If in visual mode, the currently selected lines will be used instead of the marked items.

The clipboard is shared between all graphene instances, which means you can copy, cut and paste between splits.