bn // bana notes

Sync your plain-text notes seamlessly to your cloud storage via rclone.

bn is a light bash script that opens plain-text notes in your local $EDITOR and pushes revisions instantly to your cloud storage backend via rclone. It handles background syncs, manages dependency checks, and stores everything locally inside ~/bn.

Download

↓ bn.sh - save to ~/bin/bn, chmod +x

Setup

Download bn.sh above and make it executable:

mv bn.sh ~/bin/bn && chmod +x ~/bin/bn

Ensure you have an account with a cloud provider like Google Drive, Microsoft OneDrive, Dropbox, or Box.
Run the script. If no cloud remote configuration named bn is found, it automatically provisions dependencies and runs the automated setup wizard.

🔗 Official rclone Documentation 📁 Supported Cloud Providers List

🔒 Auto-installer: If rclone is missing, bn will securely download the official standalone binary directly to your local user directory (~/.local/bin or ~/bin).

Kick off the configuration wizard by launching the script for the first time:

$ bn

Configuration missing or incomplete. Initiating cloud notes setup automatically...

Welcome to Bana Notes (bn.sh) Setup!
Let's link your notes folder to your cloud storage backend.

Choose your cloud storage provider:
  1) Google Drive
  2) Microsoft OneDrive
  3) Dropbox
  4) Box
  5) Advanced (Manual rclone setup)

Selection [1-5]: 1

Initiating secure authentication with your cloud provider...
Your web browser should open automatically to authorize Bana Notes.

The installer automatically symlinks or moves the engine script into your active terminal $PATH so you can invoke it flawlessly anywhere.

Usage

bn [options] [name]

Command	What it does
`bn`	Open (or create) default `bn.txt` note and sync to the cloud
`bn ideas`	Open `ideas.txt`, sync to the cloud on editor quit
`bn -r`	Rename a note locally and on your cloud storage
`bn -d`	Delete a note locally and on your cloud storage
`bn -b`	Backup all local `~/bn/*.txt` files to `~/bn-YYYY-MM-DD`
`bn -l`	List local notes with file size and last modified date
`bn -e`	Edit/create an encrypted note (NAME.txt.age), synced to cloud storage
`bn -p`	Pull all notes down from your cloud storage
`bn -s TERM`	Search across all local notes for a term
`bn -n`	Create or open a note with today's date
`bn -a NAME NAME`	Open multiple notes at once
`bn -x`	Reset cloud configuration to set up a different provider
`bn -h`	Show this help

Notes

Instant Shell Return Pushes to your cloud platform are completely fork-backgrounded. The terminal window yields execution control back to you instantly upon closing the file.

Error Logging Should a background network sync fault or drop connection, error exceptions are silently pushed directly to your local file stack at ~/bn/.sync_errors.

Source

The full script - copy it directly if you'd rather not download the file.

Loading bn.sh...