VFU(1)

💖 VFU(1) — the manual page, but make it cute 💖

okay bestie, listen. this is the man page for vfu, which is a console (text-mode) file manager for UNIX/Linux. it's from the User Contributed Perl Documentation section of the manual, and it's about to be your new main character. 🫶

---

✨ NAME ✨

vfu — VFU is console (text-mode) file manager for UNIX/Linux 🦋

---

🌸 SYNOPSIS 🌸

vfu [options]

that's it. that's the whole vibe. options go in, file managing comes out. 💅

---

🎀 DESCRIPTION 🎀

so here's the tea, bestie — vfu has following features:

• Fast one-key commands
• Extended completion and wildcard expansion
• Directory tree with sizes (incl. sizes cache)
• File-type colorization (extension and type)
• Archives support (TAR, TGZ, BZ2, and many more)
• Simple FTP support through archive-like interface
• Internal text/hex file viewer and editor (optional)
• Extensive user-defined external support/utils
• Regular expressions selection and search
• Multiple file masks
• and much more...

literally "and much more", no cap. the way it just keeps going 😭 it's giving iconic.

---

💅 OPTIONS 💅

• -h — prints help for command line options. bestie behaviour fr, always tell people how to use you.
• -i — runs vfu in interactive mode (can be used with -d). yes you CAN have both, it's not a toxic relationship.
• -d path — changes working directory to path. drop her off wherever you want. ✨
• -r — rebuild directory tree. glow-up for your tree.
• -t — view directory tree only. just vibes, no files.

These options are for using vfu in partial non-interactive mode.

example, since we love a demonstration:

vfu -d /usr/local -i

see? we're eating. 🍓

---

🦋 CONFIGURATION 🦋

okay so vfu configuration is divided in two parts (files):

vfu.conf

This file contains configuration for external editor and pager, favorite directories, file-type colorization. This is plain text file which format is described below. vfu only reads vfu.conf, it never writes in it!

she reads, she never writes. respectful king behavior, honestly. 👑

vfu.options

This file contains all Options/Toggles which can be changed from inside vfu — Options menu. vfu.options is binary file and is overwritten on vfu exit or on change option event! Deleting this file will reset vfu toggles to default values. vfu.options is not portable between vfu versions!

⚠️ not portable between versions, bestie. do NOT try to carry it over like a situationship. 💀

💜 Location of vfu.conf 💜

vfu.conf can be placed as any of:

$HOME/.vfu/vfu.conf

$HOME/$RC_PREFIX/vfu/vfu.conf  (if $RC_PREFIX is exported)

/etc/vfu.conf

/usr/local/etc/vfu.conf

/usr/local/vfu.conf

pick your fighter. any of them works, she's flexible. 🌈

🌸 Other files location 🌸

All other files including vfu.options are placed in:

$HOME/.vfu/

$HOME/$RC_PREFIX/vfu/

What is $RC_PREFIX and why to use it? Some more information for this can be found in the CONFIG file which is supplied with vfu package.

go read the CONFIG file, iykyk. it's giving required reading. 📖

---

⭐ VFU.CONF ⭐

This is a sample copy of vfu.conf with appropriate comments:

(she's a sample copy with comments, that's the whole thing, no further notes. the comments live in the file itself, bestie.)

---

🌈 DISTRIBUTION 🌈

It is supposed that only source packages will be distributed. However sometimes binary packages will be released, but not often. VFU packages are named in this way:

vfu-X.xx.src.tgz

source package for version X.xx

vfu-X.xx.bin.platform.tgz

binary package for version X.xx for platform platform

examples, because examples are the moment:

vfu-4.22.src.tgz

vfu-4.22.bin.linux.glibc.tgz

vfu-4.22.bin.linux.libc5.tgz

vfu-4.22.bin.dos.tgz

All packages are TAR+GZIP .tgz, bz2 and zip are available on request.

NOTE: Always check HISTORY document — it often contains some useful notes!

like, genuinely check it. it's the group chat archive of useful info. 🔥

---

🧚 FILES 🧚

$HOME/$RC_PREFIX/vfu/vfu.conf

configuration, explained above

$HOME/$RC_PREFIX/vfu/vfu.options

options, explained above

$HOME/$RC_PREFIX/vfu/vfu.history

contains history lines

$HOME/$RC_PREFIX/vfu/vfu.tree

contains directory tree

If you don't set $RC_PREFIX configuration files are:

$HOME/.vfu/vfu.conf
$HOME/.vfu/vfu.options
$HOME/.vfu/vfu.history
$HOME/.vfu/vfu.tree

so if you're not doing the $RC_PREFIX thing, those four are your girls. 🎀

---

💀 TODO 💀

see the TODO file

(yes that's the whole section. go look at the file. we don't gatekeep.) 🙈

---

😭 BUGS 😭

unknown

unknown?! iconic. she's perfect and we're choosing to believe it. ✨ no cap.

---

👑 AUTHOR 👑

 1996-2022 (c) Vladi Belperchinov-Shabakovski "Cade"
 <cade@noxrun.com> <cade@bis.bg> <cade@cpan.org>
 http://cade.noxrun.com/projects/vfu

the legend herself — "Cade" — wrote this, and we're obsessed. 🫶

---

and that's the whole page, bestie. this one shipped as part of perl v5.32.1, dated 2022-02-20, and lives at section VFU(1). slay, periodt, go manage some files. 💖✨🎀🦋