.\" 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+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 \+command
From within \fBbb\fR, running \fBbb +command\fR will execute an internal bb
command for modifying bb's state.

.B directory
Open to 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.

.SH EXAMPLES
.TP
.B
bb /usr/local/
Begin browsing in /usr/local/

.TP
.B
alias bb="cd '`/usr/local/bin/bb -d || pwd`'"
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.

.SH AUTHOR
Bruce Hill (bruce@bruce-hill.com)