fm

command module
v1.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 14, 2024 License: MIT Imports: 1 Imported by: 0

README

Keep those files organized

Latest Release GoDoc Build Status

default screenshot

About The Project

A terminal based file manager

Built With

Installation

Curl

curl -sfL https://raw.githubusercontent.com/mistakenelf/fm/main/install.sh | sh

Go

go install github.com/mistakenelf/fm@latest

AUR

Install through the Arch User Repository with your favorite AUR helper. There are currently two possible packages:

  • fm-git: Builds the package from the main branch
paru -S fm-git
  • fm-bin: Uses the github release package
paru -S fm-bin

Features

  • File icons (requires nerd font)
  • Layout adjusts to terminal resize
  • Syntax highlighting for source code with customizable themes using styles from chroma (dracula, monokai etc.)
  • Render pretty markdown
  • Mouse support
  • Themes (default, gruvbox, nord)
  • Render PNG, JPG and JPEG as strings
  • Colors adapt to terminal background, for syntax highlighting to work properly on light/dark terminals, set the appropriate theme flags
  • Open selected file in editor set in EDITOR environment variable
  • Copy selected directory items path to the clipboard
  • Read PDF files

Themes

Default

default

Gruvbox

gruvbox

Nord

nord

Usage

  • fm will start fm in the current directory
  • fm update will update fm to the latest version
  • fm --start-dir=/some/start/dir will start fm in the specified directory
  • fm --selection-path=/tmp/tmpfile will write the selected items path to the selection path when pressing E and exit fm
  • fm --start-dir=/some/dir start fm at a specific directory
  • fm --enable-logging=true start fm with logging enabled
  • fm --pretty-markdown=true render markdown using glamour to make it look nice
  • fm --theme=default set the theme of fm
  • fm --show-icons=false set whether to show icons or not
  • fm --syntax-theme=dracula sets the syntax theme to render code with

Local Development

Follow the instructions below to get setup for local development

  1. Clone the repo
git clone https://github.com/mistakenelf/fm
  1. Run
make
  1. Build a binary
make build

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
Package code implements a code bubble which renders syntax highlighted source code based on a filename.
Package code implements a code bubble which renders syntax highlighted source code based on a filename.
Package csv implements a csv bubble which renders a table with the content of the csv.
Package csv implements a csv bubble which renders a table with the content of the csv.
Package filesystem is a collection of various different filesystem helper functions.
Package filesystem is a collection of various different filesystem helper functions.
Package help implements a help bubble which can be used to display help information such as keymaps.
Package help implements a help bubble which can be used to display help information such as keymaps.
Package image provides an image bubble which can render images as strings.
Package image provides an image bubble which can render images as strings.
internal
tui
Package markdown provides an markdown bubble which can render markdown in a pretty manor.
Package markdown provides an markdown bubble which can render markdown in a pretty manor.
Package pdf provides an pdf bubble which can render pdf files as strings.
Package pdf provides an pdf bubble which can render pdf files as strings.
Package statusbar provides an statusbar bubble which can render four different status sections
Package statusbar provides an statusbar bubble which can render four different status sections

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL