wowario
/
cfiles
mirror of https://github.com/mananapr/cfiles
1
0
Fork 0
Code Issues Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '2335616856'
${ noResults }
cfiles/README.md

2.9 KiB
Raw Blame History

cfiles

cfiles is a work in progress terminal file manager with vim like keybindings, written in C using the ncurses library. It aims to provide an interface like ranger while being lightweight, fast and minimal.

screenshot

Dependencies

  • ncurses
  • cpand mv for copying and moving
  • fzf for searching
  • w3mimgdisplay for image previews
  • xdg-open for opening programs

Compiling and Installation

To compile, run

gcc cf.c -lncurses -o cf

To install, simply move the generated executable to a directory that is in your $PATH

Keybindings

Key Function
h j k l Navigation keys
G Go to end
g Go to top
f Search using fzf
F Search using fzf in the present directory
S Open Shell in present directory
Space Add to selection list
u Empty selection list
y Copy files from selection list
v Move files from selection list
a Rename Files in selection list
dD Move files from selection list to trash
r Reload
q Quit

Directories Used

cfiles uses $HOME/.cache/cfiles directory to store the clipboard file. This is used so that the clipboard can be shared between multiple instances of cfiles. That's why I won't be adding tabs in cfiles because multiple instances can be openend and managed by any terminal multiplexer or your window manager. Note that this also means the selection list will persist even if all instances are closed.

cfiles also uses $HOME/.local/share/Trash/files as the Trash Directory, so make sure this directory exists before you try to delete a file.

Why C?

I wanted to improve my C and learn ncurses so I decided this would be an ideal project.

Apart from this, I have always wanted an alternative to ranger that is faster while still having a similar UI.

Todo

  • Improve Upwards Scrolling
  • Show sorted directories before files
  • Fix the G keybinding
  • Add basic operations like deleting, copying etc.
  • Add rename functionality
  • Add option to show selection list
  • Show current progress or status of copying files
  • Show more info in the statusbar
  • Add file previews
  • Add functionality to open files
  • Add image previews using w3mimgdisplay
  • Preserve aspect ratio in image previews
  • Add fuzzy file search using fzf
  • Find a way to redraw windows after displaying image previews or running fzf
  • Find a way to remove cursor after running fzf
  • Select the file directly from fzf
  • Supress output from xdg-open
  • Find a way to remember selection position of parent directory
  • Add open in terminal functionality
  • Add color support
  • Add config file for easy user customizability
  • Refactor Code