GitHub - doctorcolossus/tab_wrangler: TUI for tabaholics · GitHub

/" data-turbo-transient="true" />

Skip to content

Type / to search

Sign in<br>Sign upAppearance settings

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

doctorcolossus

tab_wrangler

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

master

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>15 Commits<br>15 Commits

LICENSE

LICENSE

README.md

README.md

__init__.py

__init__.py

__main__.py

__main__.py

browser.py

browser.py

requirements.txt

requirements.txt

View all files

Repository files navigation

Tab Wrangler

text user interface for browser tabaholics & tab-hoarders,<br>with vim-like keybindings

Features

This program currently helps mainly:

to give a readable overview of all open browser windows and tabs,

to find and get back to things you know you have open in some window, and

to save and close windows of tabs, or groups of them.

Saved windows are currently saved to ~/urls-tab_wrangler<br>as lists of tab-separated values with two columns: title and URL.<br>Untitled ones are numbered and chucked into the untitled subfolder.

Future

The next main features I would like to implement are:

searching through and reloading previously closed windows

naming windows, hopefully with some mechanism for persistence across runs

breaking a group of tabs out into a new or existing window

implementing "undo"

Support

I wrote this for my own use, and not to share or show off.<br>I do use it on a daily basis myself, but it's still far from complete.<br>I didn't design it with other people's environments in mind.<br>I use Sway window manager in Arch Linux.<br>The feature to shift focus to an open window depends on Sway's swaymsg.<br>I have also been able to test this in Ubuntu 22.04 (Jammy Jellyfish),<br>and was able to get that same functionality using wmctrl -<br>see the commented-out line at the end of browser.py for how.<br>In the future, maybe I'll try to support and detect different environments,<br>but for now that's a low priority on the distant horizon.<br>I work on this project once in a blue moon, when I find time and motivation.

Why I'm sharing

I'm sharing this mainly in the hope of helping to keep my main dependency,<br>the amazing brotab, alive,<br>by contributing to its ecosystem. I figure the more useful software there is<br>out there which depends on it, the greater the incentive will be for everyone<br>to help keep that project alive and up-to-date. Maybe eventually people will<br>help contribute to my project too, but at least for now, at first, I can say<br>that I unfortunately won't have much time to offer support for it.

Dependencies

brotab

urwid

for shifting focus to a window:

jq

Sway window manager,<br>or alternatively wmctrl if using Ubuntu<br>(in which case uncomment the commented-out line at end of browser.py)

Usage

Currently I just keep this in ~/tab_wrangler<br>and run it from ~ with:

python -m tab_wrangler

If there's interest, I could work on making this into a proper Python package<br>and/or providing packages for Arch Linux or Debian/Ubuntu.<br>But for now I am lazy. Pull requests welcome!

Keybindings

c: Close all browser windows, saving their contents to untitled files.<br>Careful, as "undo" is not yet implemented!

d: Close ("(d)elete") a window, or group of windows.

s: (S)ave and close a window, or group of windows.

w: Name, save, and close ("(w)rite") a window, or group of windows.

enter: Focus the selected window.

/: Search forwards.

?: Search backwards.

n: Repeat last search.

N: Repeat last search in reverse.

space: Select a window. Multiple windows can be selected to save and/or close them as a group.

j: Move down a window.

k: Move up a window.

g: Jump to the first window in the list.

G: Jump to the last window in the list.

q: Quit.

About<br>TUI for tabaholics<br>Resources<br>Readme<br>GPL-3.0 license<br>Activity<br>Stars<br>8 stars<br>Watchers<br>1 watching<br>Forks<br>0 forks<br>Report repository

Releases

Packages

Used by

Contributors

Languages

You can’t perform that action at this time.