bb.1 - bb

(95 lines)
   1 .\" Manpage for bb.
   2 .\" Contact bruce@bruce-hill.com to correct errors or typos.
   3 .TH man 1 "23 Feb 2020" "0.27" "bb manual page"
   4 .SH NAME
   5 bb \- A bitty browser for command line file management
   6 .SH SYNOPSIS
   7 .B bb
   8 [\fI-d\fR]
   9 [\fI-s\fR]
  10 [\fI-0\fR]
  11 [\fI-v\fR|\fI--version\fR]
  12 [\fI-h\fR|\fI--help\fR]
  13 [+\fI<command>\fR]*
  14 [[--] \fI<directory>\fR | \fI<file>\fR]
  15 .SH DESCRIPTION
  16 \fBbb\fR is a tiny TUI console application for browsing and managing files.
  17 .SH OPTIONS
  18 .B \-d
  19 Print the current directory on exit.
  20 
  21 .B \-s
  22 Print the selected files on exit.
  23 
  24 .B \-0
  25 If printing the selected files on exit, use \fBNULL\fR-terminated strings
  26 instead of newline-separated.
  27 
  28 .B \-d
  29 Print the current directory on exit.
  30 
  31 .B \--version
  32 Print the version and exit.
  33 
  34 .B \--help
  35 Print the usage and exit.
  36 
  37 .B <command>
  38 As soon as \fBbb\fR has launched, run the given command. See \fBbbcmd\fR(1) for
  39 more details about \fBbb\fR commands.
  40 
  41 .B <directory>
  42 Open \fBbb\fR viewing this directory.
  43 
  44 .B <file>
  45 Open \fBbb\fR in the directory containing this file, with the cursor on it.
  46 
  47 .SH CONTROLS
  48 For full details on all key bindings, press \fB?\fR from inside \fBbb\fR to get
  49 a help menu.
  50 
  51 .TP
  52 .B Navigating:
  53 Arrow keys or h/j/k/l can be used to navigate.
  54 
  55 .TP
  56 .B Selecting:
  57 \fBSpace\fR is used to toggle file selection. Actions (such as copying or
  58 deleting files) are performed on the selected files. If no files are selected,
  59 actions are performed on the file under the cursor. The selection can be
  60 cleared by pressing \fBEscape\fR.
  61 
  62 .TP
  63 .B Mouse:
  64 Clicking on a file will move the cursor to it. Double clicking will open it.
  65 Clicking on the '*' column of a file will toggle that file's selection.
  66 Clicking on a column's label will sort according to that column.
  67 
  68 .SH EXAMPLES
  69 .TP
  70 .B
  71 bb /usr/local/
  72 Begin browsing in /usr/local/
  73 
  74 .TP
  75 .B
  76 alias bcd='cd "$(bb -d)"'
  77 Create an alias to launch \fBbb\fR and change directory to wherever it's located
  78 when you exit (unless you exit with Ctrl-c).
  79 
  80 .TP
  81 .B
  82 bb -s -0 | xargs -0 zip archive.zip
  83 Select some files to add to a zip archive.
  84 
  85 .TP
  86 .B
  87 bb +select: *.txt
  88 Launch \fBbb\fR with all the .txt files in the current directory selected.
  89 
  90 .SH "SEE ALSO"
  91 .sp
  92 \fBbbcmd\fR(1)
  93 
  94 .SH AUTHOR
  95 Bruce Hill (bruce@bruce-hill.com)