burf is a terminal user interface (TUI) for surfing Google Cloud Storage (GCS) buckets.
Install from PyPI:
uv tool install burf
Or run from source:
git clone git@github.com:razeghi71/burf.git
cd burf
uv sync
You can install it directly from PyPi:
pip install burf
or using source code:
git clone git@github.com:razeghi71/burf.git
cd burf
pip install .
Run via uv from source:
uv run burf --help
CLI:
usage: burf [-h] [gcs_uri]
positional arguments:
gcs_uri gcs uri to browse: gs://<bucket>/<subdir1>/<subdir2>
options:
-h, --help show this help message and exit
This app relies on Google Application Default Credentials (ADC). A common setup is:
gcloud auth application-default login
To choose which GCP project is used for listing buckets, configure it outside the app, e.g.:
gcloud config set project YOUR_PROJECT_ID
export GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID
burf is released under the MIT License.