Giter Club home page Giter Club logo

ff's Introduction

ff

ff is file manager written in Go.

Features

  • preview file/directory
  • copy/paste file
  • make a new file/directory
  • rename a file/directory
  • edit file with $EDITOR
  • open file/directory
  • bookmark directory

Go version

  • 1.13~

Support OS

  • Linux/Unix
  • Mac

Installtion

$ git clone https://github.com/skanehira/ff
$ cd ff
$ go install

NOTE: Installation with go get is not recommended because libraries's version is not locked.

Usage

Settings

If your terminal LC_CTYPE is not en_US.UTF-8, please set as following.

export LC_CTYPE=en_US.UTF-8

Options

$ ff -h
Usage of ff:
  -ignorecase
        ignore case when searching
  -log
        enable log
  -preview
        enable preview panel
  -show-hidden
        show hidden files
  -tree
        use tree mode

If you use -log that will print log. If log file not exists, then will be create in $XDG_CONFIG_HOME/ff/ff.log.

-preview is enable preview panel that you can preview file or directories.

Config

You can using config.yaml to config log, preview, etc...

# print log to file
log:
  enable: true
  file: $XDG_CONFIG_HOME/ff/ff.log

# preview the contents of file or directory
preview:
  enable: true
  # preview colorscheme. you can use colorscheme following
  # https://xyproto.github.io/splash/docs/all.html
  colorscheme: monokai

# if ignore_case is true, ignore case when searching
ignore_case: true

# if show_hidden is true, ff will display hidden files
show_hiddne: false

# if enable is true, can use bookmark
bookmark:
  enable: true
  file: $XDG_CONFIG_HOME/ff/bookmark.db

# if you use `o` to open file or directory, default ff will using `open` in MacOS, `xdg-open` in Linux.
# you can set this option to change open command.
open_mcd: open

The config.yaml should be placed in the following path.

OS path
MacOS $HOME/Library/Application Support/ff/config.yaml
Linux/Unix $XDG_CONFIG_HOME/ff/config.yaml

About bookmark

ff can use b to bookmark directory. bookmark will be stored sqlite3 database. If you want enable bookmark, you have to specify database file.

Database file will auto create when ff starting. If ff can't create database file, then will use inmemory mode.

The inmemory mode will save bookmark to memory, so if ff quit bookmarks will lost.

About Edit file

If you runing ff in Vim's terminal and $EDITOR is vim, ff will use running Vim to edit file.

Keybinding

path

key operation
Enter change directory
F1 open help panel

files

key operation
tab focus to files
j move to next
k move to previous
g move to top
G move to bottom
ctrl-b move previous page
ctrl-f move netxt page
h cd to parent path
l cd to specified path
y copy selected file or directory
x move file or directory
p paste file or directory
d delete selected file or directory
m make a new directory
n make a new file
r rename a directory or file
e edit file with $EDITOR
o open file or directory
f or / search files or directories
ctrl-j scroll preview panel down
ctrl-k scroll preview panel up
. edit config.yaml
b bookmark dirctory
B open bookmarks panel
F1 or ? open help panel

files(tree mode)

key operation
tab focus to files
j move to next
k move to previous
g move to top
G move to bottom
h cd to parent path
l cd to specified path
H move to parent path
L move to specified path
y copy selected file or directory
x move file or directory
p paste file or directory
d delete selected file or directory
m make a new directory
n make a new file
r rename a directory or file
e edit file with $EDITOR
o open file or directory
f or / search files or directories
ctrl-j scroll preview panel down
ctrl-k scroll preview panel up
. edit config.yaml
b bookmark dirctory
B open bookmarks panel
F1 or ? open help panel

bookmark

key operation
a add bookmark
d delete bookmark
q close bookmarks panel
ctrl-g go to bookmark
f// search bookmarks
F1 or ? open help panel

Author

skanehira

ff's People

Contributors

matsuyoshi30 avatar skanehira avatar

Stargazers

avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar

Watchers

avatar avatar avatar avatar

Forkers

mytxd isgasho guitarbum722 kazto matsuyoshi30 wenziwu standardgalactic wspcapital

ff's Issues

Add feature of bookmark

  • files keybinding
    b: bookmark selecting entry
    B: open bookmark list

  • bookmark list keybinding
    /: search bookmark
    Enter: open directory
    d: delete bookmark
    a: add bookmark

Paste before selecting a copy file and down

OS: WSL ubuntu 18.04
go version: go1.13.4 linux/amd64

If you enter the p key before selecting a copy file, ff goes down with an exception.
If you put it after yunk, it will work without problems.

error messages.

panic: runtime error: invalid memory address or nil pointer dereference [recovered]
        panic: runtime error: invalid memory address or nil pointer dereference
[signal SIGSEGV: segmentation violation code=0x1 addr=0x8 pc=0x7660bd]

goroutine 1 [running]:
github.com/rivo/tview.(*Application).Run.func1(0xc000265000)
        /home/user/go/pkg/mod/github.com/rivo/[email protected]/application.go:149 +0x82
panic(0x7a5160, 0xb7efc0)
        /usr/local/go/src/runtime/panic.go:679 +0x1b2
github.com/skanehira/ff/gui.(*Gui).EntryManagerKeybinding.func2(0xc0003d0540, 0xc000290001)
        /home/user/ff/gui/keybindings.go:159 +0x4ad
github.com/rivo/tview.(*Box).WrapInputHandler.func1(0xc0003d0540, 0xc000290090)
        /home/user/go/pkg/mod/github.com/rivo/[email protected]/box.go:149 +0x75
github.com/rivo/tview.(*Application).Run(0xc000265000, 0x0, 0x0)
        /home/user/go/pkg/mod/github.com/rivo/[email protected]/application.go:234 +0x415
github.com/skanehira/ff/gui.(*Gui).Run(0xc0001e0700, 0xc0001e0700, 0x7aad00)
        /home/user/ff/gui/gui.go:207 +0x7da
main.run(0xc000098120)
        /home/user/ff/main.go:33 +0xb7
main.main()
        /home/user/ff/main.go:66 +0x79

Release ARM Binaries

If possible, please can you also include ARM7/ARM64 binaries with your releases.

Add conifg file

Add config file (json or yaml) to customize log, keybinding, colors.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.