Control your browser's tabs from the terminal.
No command has been specified
usage: bt [-h] {move,list,close,activate,search,open,words,dup,windows,clients} ...
bt (brotab = Browser Tabs) is a command-line tool that helps you manage browser tabs. It can
help you list, close, reorder, open and activate your tabs.
positional arguments:
{move,list,close,activate,active,search,index,open,words,text,dup,windows,clients,install}
move move tabs around. This command lists available tabs and runs
the editor. In the editor you can 1) reorder tabs -- tabs
will be moved in the browser 2) delete tabs -- tabs will be
closed 3) change window ID of the tabs -- tabs will be moved
to specified windows
list list available tabs. The command will request all available
clients (browser plugins, mediators), and will display
browser tabs in the following format:
"<prefix>.<window_id>.<tab_id><Tab>Page title<Tab>URL"
close close specified tab IDs. Tab IDs should be in the following
format: "<prefix>.<window_id>.<tab_id>". You can use "list"
command to obtain tab IDs (first column)
activate activate given tab ID. Tab ID should be in the following
format: "<prefix>.<window_id>.<tab_id>"
active display active tabs for each client/window in the following
format: "<prefix>.<window_id>.<tab_id>"
search Search across your indexed tabs using sqlite fts5 plugin.
query Filter tabs using chrome.tabs api.
index Index the text from browser's tabs. Text is put into sqlite
fts5 table.
open open URLs from the stdin (one URL per line). One positional
argument is required: <prefix>.<window_id> OR <client>. If
window_id is not specified, URL will be opened in the active
window of the specifed client
words show sorted unique words from all active tabs of all
clients. This is a helper for webcomplete deoplete plugin
that helps complete words from the browser
text show text form all tabs
dup display reminder on how to show duplicate tabs using
command-line tools
windows display available prefixes and window IDs, along with the
number of tabs in every window
clients display available browser clients (mediators), their
prefixes and address (host:port), native app PIDs, and
browser names
install configure browser settings to use bt mediator (native
messaging app)
optional arguments:
-h, --help show this help message and exit
Features to show:
- list tabs
- close multiple tabs (fzf)
- move tabs, move, same window
- move tabs, move, different window
- move tabs, move, different browser (NOT IMPLEMENTED)
- move tabs, close
- words, complete in neovim (integration with coc, ncm2, deoplete)
- open tabs by url
- open tab by google query, search (should be extendable, NOT IMPLEMENTED)
- integration with fzf:
- activate tab
- close tabs
- integration with rofi:
- activate tab
- close tabs
- integration with albert
- index text of available tabs (requires sqlite 3.25, fts5 plugin)
- search a tab by text in albert
- show duplicate tabs and close them
- Install command-line client:
pip install brotab
- Install native app manifests:
bt install
- Install Firefox extension: https://addons.mozilla.org/en-US/firefox/addon/brotab/
- Install Chrome (Chromium) extension: https://chrome.google.com/webstore/detail/brotab/mhpeahbikehnfkfnmopaigggliclhmnc/
- Enjoy! (try
bt clients
,bt windows
,bt list
,bt words
)
To perform integration tests for the extension, chromium and firefox have different approaches to load it upon the start.
chromium: google-chrome-stable --disable-gpu --load-extension=./firefox_extension
Chromium is a bit more demading. Several conditions are required before you can run Chromium in Xvfb in integration tests:
- Use extension from brotab/extension/chrome-tests. It contains the correct
fake Key and extension ID (knldjmfmopnpolahpmmgbagdohdnhkik). The same
extension ID is installed when you run
bt install
command in Docker. This very extension ID is also present in brotab/mediator/chromium_mediator_tests.json, which is used inbt install
.
firefox: use web-ext run https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Getting_started_with_web-ext
Yuri Bochkarev
MIT