Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/night0721/ccc
Fast, small, hackable TUI file manager with no dependency
https://github.com/night0721/ccc
c c99 fff file-manager filemanager suckless tui tui-file-manager
Last synced: 4 days ago
JSON representation
Fast, small, hackable TUI file manager with no dependency
- Host: GitHub
- URL: https://github.com/night0721/ccc
- Owner: night0721
- License: gpl-3.0
- Created: 2024-03-13T18:32:39.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-01-13T09:11:13.000Z (7 days ago)
- Last Synced: 2025-01-13T10:25:17.372Z (7 days ago)
- Topics: c, c99, fff, file-manager, filemanager, suckless, tui, tui-file-manager
- Language: C
- Homepage:
- Size: 205 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ccc
Soft fork of [fff](https://github.com/bogdan-the-great/fff) in C aiming for size and speed with no dependency, hackable with patches and configurable via `config.h`
The fact that it is written in C makes it more versatile and rapid, enabling us to add features that were previously ruled out due to time complexity.
# Features
Consider this project incomplete and WIP!
| Feature of fff | Ported | Dropped |
|--------------------------------|:------:|:-------:|
| Standard movement | X | |
| Advanced movement (jumps) | X | |
| File details | X | |
| File icons! | X | |
| Searching for files | | |
| Sorting | X | |
| Marking and marking operations | | |
| Image previews | X | |
| Help | X | |
| History | | |
| Bookmarks | | |
| Bulk rename | | |
## Features added that are not in fff:
- File preview
# Usage
```sh
ccc -p dir # File picker
ccc dir
```
```
h/left/backspace: go to parent dir
j/down: scroll down
k/up: scroll up
l/right/enter: go to child dir
o: open file with
O: open file with a GUI program detached from file manager
g: go to top
G: go to bottom
ctrl+u: jump up
ctrl+d: jump down
t: go to trash dir
~: go to home dir
-: go to previous dir
z: refresh current dir
:: go to a directory by typing
.: toggle hidden files
A: show directory disk usage/block size
i: toggle file details
u: sort files
x: view file/dir attributes
e: show history
y: copy filename to clipboard
!: open shell in current dir
f: new file
n: new dir
r: rename
X: toggle executable
space: mark file
a: mark all files in directory
d: trash
[1-9]: favourites/bookmarks (see customizing)
?: show help
q: exit with last dir written to file
ctrl+c exit without writing last dir
TO BE DONE:
/: search
c: copy
m: move
s: symbolic link
b: bulk rename
p: execute paste/move/delete/bulk_rename
```
# Dependencies
- Any [Nerd Font](https://www.nerdfonts.com/) for file icons (optional, but turned on by default)
- libsixel (Optional)
# Building
You will need to run these with elevated privilages.
```
$ make
# make install
```
# Customizing
## CD on Exit for POSIX Shell
```sh
# Add this to your .bashrc, .zshrc or equivalent.
# Run 'ccc' with 'c' or whatever you decide to name the function.
c() {
ccc "$@"
cd "$(cat "${XDG_CACHE_HOME:=${HOME}/.cache}/ccc/.ccc_d")"
}
```
## Environment variables
```sh
export CCC_LAST_D=~/.cache/ccc/.ccc_d
export CCC_FAV1=~/projects
export CCC_FAV2=~/.bashrc
export CCC_FAV3=~/Pictures/Wallpapers/
export CCC_FAV4=/usr/share
export CCC_FAV5=/
export CCC_FAV6=
export CCC_FAV7=
export CCC_FAV8=
export CCC_FAV9=
```
## Using `ccc` in neovim as a file picker
See [ccc.nvim](https://github.com/night0721/ccc.nvim)
# Contributions
Contributions are welcomed, feel free to open a pull request.
# License
This project is licensed under the GNU Public License v3.0. See [LICENSE](https://github.com/night0721/ccc/blob/master/LICENSE) for more information.