88 lines
2.0 KiB
Groff
88 lines
2.0 KiB
Groff
.\" Manpage for bb.
|
|
.\" Contact bruce@bruce-hill.com to correct errors or typos.
|
|
.TH man 8 "22 May 2019" "1.0" "bb manual page"
|
|
.SH NAME
|
|
bb \- A bitty browser for command line file management
|
|
.SH SYNOPSIS
|
|
.B bb
|
|
[\fI-d\fR]
|
|
[\fI-s\fR]
|
|
[\fI-0\fR]
|
|
[\fI-v\fR|\fI--version\fR]
|
|
[\fI-h\fR|\fI--help\fR]
|
|
[\fI+command\fR]*
|
|
[\fIdirectory\fR]
|
|
.SH DESCRIPTION
|
|
\fBbb\fR is a tiny TUI console application for browsing and managing files.
|
|
.SH OPTIONS
|
|
.B \-d
|
|
Print the current directory on exit.
|
|
|
|
.B \-s
|
|
Print the selected files on exit.
|
|
|
|
.B \-0
|
|
If printing the selected files on exit, use NULL-terminated strings instead of
|
|
newline-separated.
|
|
|
|
.B \-d
|
|
Print the current directory on exit.
|
|
|
|
.B \--version
|
|
Print the version and exit.
|
|
|
|
.B \--help
|
|
Print the usage and exit.
|
|
|
|
.B +command
|
|
As soon as \fBbb\fR has launched, run the given command.
|
|
|
|
.B directory
|
|
Open \fBbb\fR viewing this directory.
|
|
|
|
.SH CONTROLS
|
|
For full details on all key bindings, press \fB?\fR from inside \fBbb\fR to get
|
|
a help menu.
|
|
|
|
.TP
|
|
.B Navigating:
|
|
Arrow keys or h/j/k/l can be used to navigate.
|
|
|
|
.TP
|
|
.B Selecting:
|
|
\fBSpace\fR is used to toggle file selection. Actions (such as copying or
|
|
deleting files) are performed on the selected files. If no files are selected,
|
|
actions are performed on the file under the cursor. The selection can be
|
|
cleared by pressing \fBEscape\fR.
|
|
|
|
.TP
|
|
.B Mouse:
|
|
Clicking on a file will move the cursor to it. Double clicking will open it.
|
|
Clicking on the '*' column of a file will toggle that file's selection.
|
|
Clicking on a column's label will sort according to that column.
|
|
|
|
.SH EXAMPLES
|
|
.TP
|
|
.B
|
|
bb /usr/local/
|
|
Begin browsing in /usr/local/
|
|
|
|
.TP
|
|
.B
|
|
alias bcd="cd '`bb -d`'"
|
|
Create an alias to launch \fBbb\fR and change directory to wherever it's located
|
|
when you exit (unless you exit with Ctrl-c).
|
|
|
|
.TP
|
|
.B
|
|
bb -s -0 | xargs -0 zip archive.zip
|
|
Select some files to add to a zip archive.
|
|
|
|
.TP
|
|
.B
|
|
bb +select: *.txt
|
|
Launch \fBbb\fR with all the .txt files in the current directory selected.
|
|
|
|
.SH AUTHOR
|
|
Bruce Hill (bruce@bruce-hill.com)
|